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

string

Die ID der Präsentation.
pageSize

object (Size)

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

object (Page)

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

string

Der Titel der Präsentation.
masters[]

object (Page)

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

  • Platzhalterformen auf einem Master enthalten die Standardtextstile und Formattribute aller Platzhalterformen auf Seiten, die diesen Master verwenden.
  • Die Masterseiteneigenschaften definieren die allgemeinen Seiteneigenschaften, die von den Layouts geerbt werden.
  • Alle anderen Formen auf der Masterfolie werden auf allen Folien angezeigt, die diesen Master verwenden, unabhängig vom Layout.
layouts[]

object (Page)

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

string

Das Gebietsschema der Präsentation als IETF BCP 47-Sprachcode.
revisionId

string

Nur Ausgabe. Die Revisions-ID der Präsentation. Kann in Aktualisierungsanfragen verwendet werden, um zu bestätigen, dass sich die Präsentationsrevision seit dem letzten Lesevorgang nicht geändert hat. Wird nur ausgefüllt, wenn der Nutzer Bearbeitungszugriff auf die Präsentation hat.

Die Revisions-ID ist keine fortlaufende Nummer, sondern ein undurchsichtiger String. Das Format der Revisions-ID kann sich im Laufe der Zeit ändern. Sie sollte daher undurchsichtig behandelt werden. Eine zurückgegebene Revisions-ID ist nur 24 Stunden nach der Rückgabe gültig und kann nicht für mehrere Nutzer freigegeben werden. Wenn sich die Revisions-ID zwischen den Aufrufen nicht ändert, hat sich auch 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 aber auch auf interne Faktoren wie Änderungen des ID-Formats zurückzuführen sein.
notesMaster

object (Page)

Der Notizenmaster in der Präsentation. Er dient drei Zwecken:

  • Platzhalterformen auf einem Notizenmaster enthalten die Standardtextstile und Formattribute aller Platzhalterformen auf notes pages. Insbesondere enthält eine SLIDE_IMAGE-Platzhalterform die Folienminiatur und eine BODY-Platzhalterform die Vortragsnotizen.
  • Die Eigenschaften der Notizenmasterseite definieren die allgemeinen Seiteneigenschaften, die von allen notes pages geerbt werden.
  • Alle anderen Formen auf dem Notizenmaster werden auf allen notes pages angezeigt.

Der Notizenmaster ist schreibgeschützt.
comments[]

object (CommentThread)

Nur Ausgabe. Die Kommentarthreads, die mit der Präsentation verknüpft sind.

commentsViewMode

enum (CommentsViewMode)

Nur Ausgabe. Der auf die Präsentation angewendete Kommentaransichtsmodus.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, 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 Autorisierungsleitfaden.