Method: presentations.batchUpdate

Wprowadza co najmniej jedną zmianę w prezentacji.

Każdy request jest weryfikowany przed zastosowaniem. Jeśli którakolwiek prośba jest nieprawidłowa, cała prośba zostanie odrzucona i nie zostanie zastosowana.

Niektóre żądania mają przycisk replies, który zawiera informacje o sposobie ich zastosowania. Inne żądania nie muszą zwracać informacji. Zwracają one pustą odpowiedź. Kolejność odpowiedzi odpowiada kolejności żądań.

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

Ponieważ inne osoby mogą edytować prezentację, może ona nie odzwierciedlać dokładnie Twoich zmian: mogą one zostać zmienione w zależności od zmian wprowadzonych przez współpracowników. Jeśli nie ma współpracowników, prezentacja powinna odzwierciedlać Twoje zmiany. W każdym razie zmiany w prośbie są zawsze stosowane jako całość.

Żą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 mają zostać zastosowane zmiany.

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 do zastosowania w prezentacji.
writeControl

object (WriteControl)

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

Treść odpowiedzi

wiadomość z odpowiedzią na zbiorczą aktualizację.

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, w której zastosowano aktualizacje.
replies[]

object (Response)

Odpowiedź na aktualizacje. Odpowiadają one 1:1 aktualizacjom, ale odpowiedzi na niektóre żądania mogą być puste.
writeControl

object (WriteControl)

Zaktualizowany element kontroli zapisu po zastosowaniu prośby.

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 dotyczącym autoryzacji.

WriteControl

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

Zapis JSON 
{
  "requiredRevisionId": string
}
Pola
requiredRevisionId

string

revision ID prezentacji wymagany do żądania zapisu. Jeśli wymagany identyfikator wersji nie pasuje do bieżącego identyfikatora wersji prezentacji, żądanie nie zostanie przetworzone i zwróci błąd 400 „Nieprawidłowy żądanie”.

Gdy wymagany identyfikator wersji jest zwracany w odpowiedzi, wskazuje identyfikator wersji dokumentu po zastosowaniu żądania.