Method: presentations.batchUpdate

Wendet mindestens ein Update 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.

Für einige Anfragen sind replies erforderlich, um Informationen zu ihrer Anwendung zu erhalten. Bei anderen Anfragen müssen keine Informationen zurückgegeben werden. geben beide eine leere Antwort zurück. 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 die Präsentation möglicherweise von anderen Nutzern bearbeitet wird, spiegelt die Präsentation Ihre Änderungen möglicherweise nicht genau wider: Ihre Änderungen werden möglicherweise im Hinblick auf die Änderungen der Mitbearbeiter angepasst. Wenn es keine Mitbearbeiter gibt, sollten Ihre Änderungen in der Präsentation widergespiegelt werden. In jedem Fall werden die Aktualisierungen in Ihrer Anfrage garantiert gemeinsam 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 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)

Bietet Kontrolle darüber, wie Schreibanfragen ausgeführt werden.

Antworttext

Antwortnachricht aus einer Batch-Aktualisierung.

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 Aktualisierungen angewendet wurden.
replies[]

object (Response)

Die Antwort auf die Aktualisierungen. Dies entspricht 1:1 den Aktualisierungen, wobei auf einige Anfragen möglicherweise leer ist.
writeControl

object (WriteControl)

Das aktualisierte Schreibsteuerelement nach dem Anwenden 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

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 Sie diesen Parameter angeben und die erforderliche Überarbeitungs-ID nicht mit der aktuellen Überarbeitungs-ID der Präsentation übereinstimmt, wird die Anfrage nicht verarbeitet und der Fehler 400 bei der ungültigen Anfrage 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.