Method: presentations.batchUpdate

Wendet eine oder mehrere Änderungen auf die Präsentation an.

Jede request wird vor der Anwendung validiert. Wenn eine Anfrage ungültig ist, schlägt die gesamte Anfrage fehl und es werden keine Änderungen vorgenommen.

Einige Anfragen haben replies, um Ihnen Informationen zur Anwendung zu geben. Bei anderen Anfragen müssen keine Informationen zurückgegeben werden. Hier wird jeweils eine leere Antwort zurückgegeben. Die Reihenfolge der Antworten entspricht der Reihenfolge der Anfragen.

Angenommen, Sie rufen „batchUpdate“ mit vier Aktualisierungen auf und nur die dritte gibt Informationen zurück. Die Antwort würde zwei leere Antworten enthalten: die Antwort auf die dritte Anfrage und eine weitere leere Antwort, in dieser Reihenfolge.

Da andere Nutzer die Präsentation bearbeiten können, spiegelt sie möglicherweise nicht genau Ihre Änderungen wider. Ihre Änderungen können sich aufgrund der Änderungen der Mitbearbeiter ändern. Wenn es keine Mitbearbeiter gibt, sollten Ihre Änderungen in der Präsentation berücksichtigt werden. In jedem Fall werden die Aktualisierungen in Ihrer Anfrage garantiert gemeinsam in kleinstmöglichen Schritten 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 Änderungen 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 Änderungen, die auf die Präsentation angewendet werden sollen.
writeControl

object (WriteControl)

Steuert, 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 auf die Aktualisierungen. Die Zuordnung erfolgt 1:1 mit den Updates, auch wenn die Antworten auf einige Anfragen leer sein können.
writeControl

object (WriteControl)

Die aktualisierte Schreibsteuerung 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.

WriteControl

Steuert, 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 Revisions-ID angegeben ist und nicht mit der aktuellen Revisions-ID der Präsentation übereinstimmt, wird die Anfrage nicht verarbeitet und es wird der Fehler 400 zurückgegeben.

Wenn in einer Antwort eine erforderliche Versions-ID zurückgegeben wird, gibt sie die Versions-ID des Dokuments nach Anwendung der Anfrage an.