Erstellt eine leere Präsentation mit dem in der Anfrage angegebenen Titel. Wenn eine presentationId
angegeben ist, wird sie als ID der neuen Präsentation verwendet. Andernfalls wird eine neue ID generiert. Andere Felder in der Anfrage, einschließlich der bereitgestellten 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 der Präsentation. Folien übernehmen die Eigenschaften eines Folienlayouts. |
title |
Der Titel der Präsentation. |
masters[] |
Die Folienmaster in der Präsentation. Ein Folienmaster enthält alle gängigen Seitenelemente und die allgemeinen Eigenschaften für eine Reihe von Layouts. Sie dienen drei Zwecken:
|
layouts[] |
Die Layouts in der Präsentation. Ein Layout ist eine Vorlage, die bestimmt, wie Inhalte auf den Folien angeordnet und gestaltet werden, die von diesem Layout übernommen werden. |
locale |
Die Sprache der Präsentation als IETF BCP 47-Sprachtag. |
revisionId |
Nur Ausgabe. Die Überarbeitungs-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. Das Feld wird nur ausgefüllt, wenn der Nutzer Bearbeitungszugriff auf die Präsentation hat. Die Überarbeitungs-ID ist keine fortlaufende Nummer, sondern ein nebelhafter 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 mit anderen Nutzern geteilt werden. Wenn die Überarbeitungs-ID zwischen den Aufrufen unverändert bleibt, bleibt die Präsentation unverändert. Umgekehrt bedeutet eine geänderte ID (für dieselbe Präsentation und denselben Nutzer) normalerweise, 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 |
Der Notizenmaster 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.