Method: presentations.batchUpdate

Wendet eine oder mehrere Aktualisierungen auf die Präsentation an.

Jede request muss vor der Anwendung validiert werden. Wenn eine Anfrage ungültig ist, schlägt die gesamte Anfrage fehl und es wird nichts angewendet.

Bei einigen Anfragen gibt es replies, um Ihnen Informationen zur Anwendung zu geben. Bei anderen Anfragen müssen keine Informationen zurückgegeben werden, da sie jeweils eine leere Antwort zurückgeben. Die Reihenfolge der Antworten stimmt mit der der Anfragen überein.

Beispiel: Sie rufen „BatchUpdate“ mit vier Updates auf und nur das dritte gibt Informationen zurück. Die Antwort hätte zwei leere Antworten: die Antwort auf die dritte Anfrage und eine weitere leere Antwort in dieser Reihenfolge.

Da andere Nutzer die Präsentation bearbeiten, treffen diese möglicherweise nicht immer genau auf die Präsentation zu. Ihre Änderungen können im Hinblick auf die Änderungen von Mitbearbeitern angepasst werden. Wenn keine Mitbearbeiter vorhanden sind, sollten Ihre Änderungen in der Präsentation widergespiegelt werden. In jedem Fall werden die Aktualisierungen in Ihrer Anfrage garantiert einheitlich angewendet.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
presentationId

string

Die Präsentation, auf die die Aktualisierungen angewendet werden sollen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Felder
requests[]

object (Request)

Eine Liste der Aktualisierungen, die auf die Präsentation angewendet werden sollen.
writeControl

object (WriteControl)

Hiermit wird gesteuert, wie Schreibanfragen ausgeführt werden.

Antworttext

Antwortnachricht von einem Batch-Update.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Felder
presentationId

string

Die Präsentation, auf die die Änderungen angewendet wurden
replies[]

object (Response)

Die Antwort zu den Updates. Diese Karte wird zu 1:1 zugeordnet und die Antworten können leer sein.
writeControl

object (WriteControl)

Das aktualisierte Schreibsteuerelement nach Anwendung der Anfrage.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

Schreibsteuerung

Hiermit wird gesteuert, wie Schreibanfragen ausgeführt werden.

JSON-Darstellung 
{
  "requiredRevisionId": string
}
Felder
requiredRevisionId

string

Die revision ID der Präsentation, die für die Schreibanfrage erforderlich ist. Wenn die erforderliche Überarbeitungs-ID angegeben wird und nicht mit der aktuellen Überarbeitungs-ID der Präsentation übereinstimmt, wird die Anfrage nicht verarbeitet und der Fehler 400 wird zurückgegeben.

Wenn eine erforderliche Überarbeitungs-ID in einer Antwort zurückgegeben wird, gibt sie die Überarbeitungs-ID des Dokuments an, nachdem die Anfrage angewendet wurde.