Method: presentations.create

Erstellt eine leere Präsentation mit dem im Antrag 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 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 (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 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 gemeinsamen Seitenelemente und die gemeinsamen Eigenschaften für eine Reihe von Layouts. Sie dienen drei Zwecken:

  • Platzhalterformen auf einer Masterfolie enthalten die Standardtextstile und Formeigenschaften aller Platzhalterformen auf Seiten, die diese Masterfolie verwenden.
  • Die Eigenschaften der Masterseite 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 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 sind.
locale

string

Der Sprachcode der Präsentation als IETF BCP 47-Sprachtag.
revisionId

string

Nur Ausgabe. Die Revisions-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 angegeben, wenn der Nutzer Bearbeitungszugriff auf die Präsentation hat.

Die Überarbeitungs-ID ist keine fortlaufende Nummer, sondern ein unbestimmter String. Das Format der Revisions-ID kann sich im Laufe der Zeit ändern. Sie sollte daher als opake Kennung 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 die Überarbeitungs-ID zwischen den Aufrufen unverändert ist, hat sich die Präsentation nicht geändert. Eine geänderte ID (für dieselbe Präsentation und denselben Nutzer) bedeutet 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

object (Page)

Die Notizenmasterfolie in der Präsentation. Sie dient drei Zwecken:

  • Platzhalterformen auf einer Notizenmasterfolie enthalten die Standardtextstile und Formeigenschaften aller Platzhalterformen auf notes pages. Genauer gesagt enthält ein SLIDE_IMAGE-Platzhalter das Folien-Thumbnail und ein BODY-Platzhalter die Vortragsnotizen.
  • Die Eigenschaften der Master-Notizenseite definieren die gemeinsamen Seiteneigenschaften, die von allen notes pages übernommen werden.
  • Alle anderen Formen im Noten-Master werden auf allen notes pages angezeigt.

Die Notizen-Masterfolie ist schreibgeschützt.
comments[]

object (CommentThread)

Nur Ausgabe. Die mit der Präsentation verknüpften Kommentarthreads.
commentsViewMode

enum (CommentsViewMode)

Nur Ausgabe. Der auf die Präsentation angewendete Ansichtsmodus für Kommentare.

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.