- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Anfrage
- CreateSlideRequest
- LayoutReference
- Vordefiniertes Layout
- LayoutPlatzhalterIdMapping
- CreateShapeRequest
- PageElementProperties.
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- ReplaceAllTextRequest
- SubstringMatchCriteria
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode (Modus anwenden)
- UpdateSlidesPositionRequest
- DeleteTextRequest
- Bereich
- Typ
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- Verknüpfungsmodus
- CreateLineRequest
- Kategorie
- RefreshSheetsChartRequest
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletsRequest
- Bullet-Glyphpreset
- ReplaceAllShapesWithImageRequest
- Ersetzen
- Bildersetzungsmethode
- DuplicateObjectRequest
- UpdateTextStyleRequest
- ReplaceAllShapesWithSheetsDiagrammRequest
- Verknüpfungsmodus
- DeleteParagraphBulletsRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- Rahmenposition
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- ReplaceImageRequest
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- Antwort
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- ReplaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateTabellenChartResponse
- CreateLineResponse
- ReplaceAllShapesWithImageResponse
- DuplicateObjectResponse
- ReplaceAllShapesWithSheetsDiagrammResponse
- GroupObjectsResponse
- Testen!
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 |
Die Präsentation, auf die die Aktualisierungen angewendet werden sollen. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "requests": [ { object ( |
Felder | |
---|---|
requests[] |
Eine Liste der Aktualisierungen, die auf die Präsentation angewendet werden sollen. |
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 ( |
Felder | |
---|---|
presentationId |
Die Präsentation, auf die die Änderungen angewendet wurden |
replies[] |
Die Antwort zu den Updates. Diese Karte wird zu 1:1 zugeordnet und die Antworten können leer sein. |
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 |
Die Wenn eine erforderliche Überarbeitungs-ID in einer Antwort zurückgegeben wird, gibt sie die Überarbeitungs-ID des Dokuments an, nachdem die Anfrage angewendet wurde. |