Method: presentations.batchUpdate

Wendet ein oder mehrere Updates 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 wird nichts angewendet.

Einige Anfragen haben replies, um Ihnen Informationen zur Anwendung zu geben. Bei anderen Anfragen müssen keine Informationen zurückgegeben werden. In diesen Fällen 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, werden Ihre Änderungen möglicherweise nicht genau so angezeigt, wie Sie sie vorgenommen haben. Wenn es keine Mitbearbeiter gibt, sollten Ihre Änderungen in der Präsentation zu sehen sein. In jedem Fall werden die Aktualisierungen in Ihrer Anfrage garantiert atomar 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 Aktualisierungen, die auf die Präsentation angewendet werden sollen.
writeControl

object (WriteControl)

Bietet Kontrolle darüber, 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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Felder
presentationId

string

Die Präsentation, auf die die Aktualisierungen angewendet wurden.
replies[]

object (Response)

Die Antwort auf die Updates. Dies entspricht 1:1 den Updates, obwohl Antworten auf einige Anfragen leer sein können.
writeControl

object (WriteControl)

Die aktualisierte Schreibsteuerung nach Anwendung der Anfrage.
commentUpdateState

enum (CommentUpdateState)

Gibt an, ob Kommentaraktualisierungen in der Batchanfrage angewendet wurden.

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 Autorisierungsleitfaden.

WriteControl

Bietet Kontrolle darüber, 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 angegeben und die erforderliche Revisions-ID nicht mit der aktuellen Revisions-ID der Präsentation übereinstimmt, wird die Anfrage nicht verarbeitet und es wird der Fehler „400 Bad Request“ zurückgegeben.

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

CommentUpdateState

Der Status von Kommentaraktualisierungen in der Batchanfrage.

Enums
COMMENT_UPDATE_STATE_UNSPECIFIED Der Status von Kommentaraktualisierungen ist nicht angegeben.
NO_UPDATES_REQUESTED In der Batchanfrage wurden keine Kommentaraktualisierungen angefordert.
ALL_SAVED Alle angeforderten Kommentaraktualisierungen wurden in der Batchanfrage angewendet.
ALL_FAILED_UNKNOWN_REASON Alle angeforderten Kommentaraktualisierungen sind fehlgeschlagen.