Method: presentations.batchUpdate

Stosuje co najmniej jedną aktualizację do prezentacji.

Każda request jest weryfikowana przed zastosowaniem. Jeśli którekolwiek żądanie jest nieprawidłowe, całe żądanie zakończy się niepowodzeniem i nic nie zostanie zastosowane.

Niektóre prośby mają ikonę replies, która zawiera informacje o sposobie ich zastosowania. Inne żądania nie muszą zwracać informacji. W takich przypadkach zwracana jest pusta odpowiedź. Kolejność odpowiedzi jest zgodna z kolejnością żądań.

Załóżmy na przykład, że wywołujesz batchUpdate z 4 aktualizacjami, a tylko trzecia z nich zwraca informacje. Odpowiedź będzie zawierać 2 puste odpowiedzi: odpowiedź na trzecie żądanie i kolejną pustą odpowiedź.

Ponieważ inni użytkownicy mogą edytować prezentację, może ona nie odzwierciedlać dokładnie Twoich zmian. Mogą one zostać zmienione w związku ze zmianami wprowadzonymi przez współpracowników. Jeśli nie ma współpracowników, prezentacja powinna odzwierciedlać Twoje zmiany. W każdym przypadku zmiany w Twoim żądaniu zostaną zastosowane razem w sposób niepodzielny.

Żądanie HTTP

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
presentationId

string

prezentację, do której mają zostać zastosowane aktualizacje;

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Pola
requests[]

object (Request)

Lista aktualizacji, które można zastosować w prezentacji.
writeControl

object (WriteControl)

Umożliwia kontrolowanie sposobu wykonywania żądań zapisu.

Treść odpowiedzi

Wiadomość z odpowiedzią po aktualizacji zbiorczej.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Pola
presentationId

string

Prezentacja, w której zastosowano aktualizacje.
replies[]

object (Response)

Odpowiedź na aktualizacje. Jest to mapowanie 1:1 z aktualizacjami, chociaż odpowiedzi na niektóre żądania mogą być puste.
writeControl

object (WriteControl)

Zaktualizowana kontrola zapisu po zastosowaniu żądania.
commentUpdateState

enum (CommentUpdateState)

Informacja o tym, czy aktualizacje komentarzy zostały zastosowane w żądaniu zbiorczym.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.

WriteControl

Umożliwia kontrolowanie sposobu wykonywania żądań zapisu.

Zapis JSON 
{
  "requiredRevisionId": string
}
Pola
requiredRevisionId

string

revision ID prezentacji wymagany w przypadku żądania zapisu. Jeśli ten parametr jest określony, a wymagany identyfikator wersji nie pasuje do bieżącego identyfikatora wersji prezentacji, żądanie nie jest przetwarzane i zwraca błąd 400 (Nieprawidłowe żądanie).

Gdy w odpowiedzi zostanie zwrócony wymagany identyfikator wersji, oznacza to identyfikator wersji dokumentu po zastosowaniu żądania.

CommentUpdateState

Stan aktualizacji komentarzy w żądaniu zbiorczym.

Wartości w polu enum
COMMENT_UPDATE_STATE_UNSPECIFIED Stan aktualizacji komentarzy jest nieokreślony.
NO_UPDATES_REQUESTED W żądaniu zbiorczym nie przesłano żadnych próśb o aktualizację komentarzy.
ALL_SAVED W żądaniu zbiorczym zastosowano wszystkie aktualizacje komentarzy.
ALL_FAILED_UNKNOWN_REASON Nie udało się zaktualizować wszystkich żądanych komentarzy.