Method: presentations.batchUpdate

Powoduje zastosowanie co najmniej jednej aktualizacji do prezentacji.

Każdy element typu request jest weryfikowany przed zastosowaniem. Jeśli któreś żądanie jest nieprawidłowe, całe żądanie zakończy się niepowodzeniem i nic nie zostanie zastosowane.

W przypadku niektórych żądań replies informuje o sposobie ich stosowania. W przypadku innych żądań nie trzeba zwracać informacji. Każdy z nich zwraca pustą odpowiedź. Kolejność odpowiedzi jest zgodna z kolejnością żądań.

Załóżmy na przykład, że wywołujesz funkcję wsad do aktualizacji z czterema aktualizacjami, a tylko trzecia zwraca informacje. Odpowiedź zawiera 2 puste odpowiedzi: odpowiedź na trzecie żądanie i drugą w tej kolejności pustą odpowiedź.

Ponieważ inni użytkownicy mogą edytować tę prezentację, prezentacja może nie odzwierciedlać dokładnie wprowadzonych przez Ciebie zmian: Twoje zmiany mogą zostać zmodyfikowane w związku ze zmianami wprowadzonymi przez współpracowników. Jeśli nie ma współpracowników, prezentacja powinna odzwierciedlać wprowadzone zmiany. W każdym przypadku aktualizacje w żądaniu zostaną zastosowane razem atomowo.

Żą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

Prezentacja, do której chcesz zastosować 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 mają zostać zastosowane do prezentacji.
writeControl

object (WriteControl)

Zapewnia kontrolę nad sposobem wykonywania żądań zapisu.

Treść odpowiedzi

Komunikat odpowiedzi z aktualizacji zbiorczej.

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

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

string

Prezentacja, do której zastosowano zmiany.
replies[]

object (Response)

Odpowiedź na aktualizacje. Wynika to z tego 1:1 na podstawie aktualizacji, chociaż odpowiedzi na niektóre prośby mogą być puste.
writeControl

object (WriteControl)

Zaktualizowany element sterujący zapisu po zastosowaniu żądania.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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 na temat autoryzacji.

WriteControl

Zapewnia kontrolę nad sposobem wykonywania żądań zapisu.

Zapis JSON 
{
  "requiredRevisionId": string
}
Pola
requiredRevisionId

string

Element revision ID prezentacji wymagany w żądaniu zapisu. Jeśli podasz określony identyfikator, a wymagany identyfikator wersji nie jest zgodny z bieżącym identyfikatorem wersji prezentacji, żądanie nie zostanie przetworzone i zwróci błąd 400.

Jeśli w odpowiedzi zostanie zwrócony wymagany identyfikator wersji, wskazuje on identyfikator wersji dokumentu po zastosowaniu żądania.