Method: presentations.batchUpdate

Stosuje co najmniej jedną aktualizację prezentacji.

Każdy request jest sprawdzany przed zastosowaniem. Jeśli któreś z żądań jest nieprawidłowe, nie powiedzie się żadne żądanie.

Niektóre żądania zawierają dane replies, które zawierają informacje o tym, jak je stosujemy. Inne żądania nie muszą zwracać informacji. Każde takie żądanie zwraca pustą odpowiedź. Kolejność odpowiedzi jest zgodna z kolejnością.

Załóżmy na przykład, że wywołujesz funkcję updateUpdate z 4 aktualizacjami i tylko 3 z nich zwraca informacje. Odpowiedź miałaby dwie puste odpowiedzi: odpowiedź na trzecie żądanie i kolejną pustą odpowiedź w tej kolejności.

Ponieważ inni użytkownicy mogą edytować prezentację, prezentacja może nie odzwierciedlać dokładnie Twoich zmian: modyfikacje te mogą być inne w stosunku do zmian wprowadzonych przez współpracowników. Jeśli nie masz współpracowników, prezentacja powinna odzwierciedlać zmiany. W każdym przypadku aktualizacje w żądaniu są gwarantowane razem.

Żą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, w 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ą być zastosowane w prezentacji.
writeControl

object (WriteControl)

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

Treść odpowiedzi

Odpowiedź 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 zostały zastosowane aktualizacje.
replies[]

object (Response)

Odpowiedź na aktualizacje. Odpowiada on mapom 1:1 zawierającym aktualizacje, chociaż odpowiedzi na niektóre żądania mogą być puste.
writeControl

object (WriteControl)

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

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.

Element sterujący zapisu

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

Zapis JSON 
{
  "requiredRevisionId": string
}
Pola
requiredRevisionId

string

revision ID prezentacji wymagany do zapisu. Jeśli identyfikator wersji jest wymagany i nie odpowiada obecnemu identyfikatorowi wersji prezentacji, żądanie nie jest przetwarzane i zwraca błąd 400.

Zwrócony w odpowiedzi wymagany identyfikator wersji wskazuje identyfikator wersji dokumentu po zastosowaniu żądania.