Erstellt eine leere Präsentation unter Verwendung des in der Anfrage angegebenen Titels. Wenn ein presentationId
angegeben ist, wird dieser als ID der neuen Präsentation verwendet. Andernfalls wird eine neue ID generiert. Andere Felder in der Anfrage, einschließlich der angegebenen Inhalte, werden ignoriert. Gibt die erstellte Präsentation zurück.
HTTP-Anfrage
POST https://slides.googleapis.com/v1/presentations
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "presentationId": string, "pageSize": { object ( |
Felder | |
---|---|
presentationId |
Die ID der Präsentation. |
pageSize |
Die Größe der Seiten in der Präsentation. |
slides[] |
Die Folien in der Präsentation. Eine Folie übernimmt die Eigenschaften des Folienlayouts. |
title |
Der Titel der Präsentation. |
masters[] |
Die Folienmeister in der Präsentation. Ein Folienmaster enthält alle allgemeinen Seitenelemente und die allgemeinen Eigenschaften für einen Satz von Layouts. Sie dienen drei Zwecken:
|
layouts[] |
Die Layouts in der Präsentation. Ein Layout ist eine Vorlage, mit der festgelegt wird, wie Inhalte auf den Folien angeordnet und gestaltet werden, die aus diesem Layout übernommen werden. |
locale |
Die Sprache der Präsentation als Sprach-Tag gemäß IETF BCP 47. |
revisionId |
Nur Ausgabe Die Versions-ID der Präsentation. Kann in Aktualisierungsanfragen verwendet werden, um zu bestätigen, dass sich die Präsentationsüberarbeitung seit dem letzten Lesevorgang nicht geändert hat. Wird nur ausgefüllt, wenn der Nutzer Bearbeitungszugriff auf die Präsentation hat. Die Überarbeitungs-ID ist keine fortlaufende Nummer, sondern ein unklarer String. Das Format der Überarbeitungs-ID kann sich im Laufe der Zeit ändern. Daher sollte sie undurchsichtig behandelt werden. Eine zurückgegebene Überarbeitungs-ID ist nach der Rückgabe nur 24 Stunden lang gültig und kann nicht für andere Nutzer freigegeben werden. Wenn sich die Überarbeitungs-ID zwischen den Aufrufen nicht ändert, bleibt die Präsentation unverändert. Umgekehrt bedeutet eine geänderte ID (für dieselbe Präsentation und denselben Nutzer) in der Regel, dass die Präsentation aktualisiert wurde. Eine geänderte ID kann jedoch auch auf interne Faktoren wie Änderungen des ID-Formats zurückzuführen sein. |
notesMaster |
Das Master-Element in der Präsentation. Sie dient drei Zwecken:
Der Notizenmaster ist schreibgeschützt. |
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Presentation
.
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/presentations
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.