Method: presentations.create

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. Die erstellte Präsentation wird zurückgegeben.

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 (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Felder
presentationId

string

Die ID der Präsentation.
pageSize

object (Size)

Die Größe der Seiten in der Präsentation.
slides[]

object (Page)

Die Folien in der Präsentation. Eine Folie erbt Eigenschaften von einem Folienlayout.
title

string

Der Titel der Präsentation.
masters[]

object (Page)

Die Folienmaster in der Präsentation. Ein Folienmaster enthält alle gängigen Seitenelemente und die gemeinsamen Eigenschaften für eine Reihe von Layouts. Sie dienen drei Zwecken:

  • Platzhalterformen in einem Master enthalten die Standardtextstile und -formeigenschaften aller Platzhalterformen auf Seiten, für die dieses Master verwendet wird.
  • Die Masterseiteneigenschaften definieren die gemeinsamen Seiteneigenschaften, die von den Layouts übernommen werden.
  • Alle anderen Formen auf der Masterfolie werden auf allen Folien angezeigt, die dieses Master verwenden, unabhängig von ihrem Layout.
layouts[]

object (Page)

Die Layouts in der Präsentation. Ein Layout ist eine Vorlage, die festlegt, wie Inhalte auf den Folien angeordnet und formatiert werden, die von diesem Layout übernommen werden.
locale

string

Die Sprache der Präsentation als IETF BCP 47-Sprachcode.
revisionId

string

Nur Ausgabe. Die Versions-ID der Präsentation. Kann in Aktualisierungsanfragen verwendet werden, um zu bestätigen, dass sich die Präsentationsversion 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 Revision-ID kann sich im Laufe der Zeit ändern. Daher sollte sie nicht transparent behandelt werden. Eine zurückgegebene Versions-ID ist nur 24 Stunden nach der Rückgabe gültig und kann nicht für mehrere Nutzer verwendet werden. Wenn sich die Überarbeitungs-ID zwischen den Aufrufen nicht ändert, hat sich die Präsentation nicht geä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 am ID-Format zurückzuführen sein.
notesMaster

object (Page)

Das Notizen-Master in der Präsentation. Er dient drei Zwecken:

  • Platzhalterformen auf einem Notizenmaster enthalten die Standardtextstile und -formeigenschaften aller Platzhalterformen auf notes pages. Insbesondere enthält eine SLIDE_IMAGE-Platzhalterform die Folienminiaturansicht und eine BODY-Platzhalterform die Sprechernotizen.
  • Die Eigenschaften der Masterseite für Notizen definieren die gemeinsamen Seiteneigenschaften, die von allen notes pages übernommen werden.
  • Alle anderen Formen im Notizenmaster werden auf allen notes pages angezeigt.

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.