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. 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)
  }
}
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 der Präsentation. Folien übernehmen die Eigenschaften eines Folienlayouts.

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 allgemeinen Eigenschaften für eine Reihe von Layouts. Sie dienen drei Zwecken:

  • Platzhalterformen in einem Master enthalten die Standardtextstile und die Standardformeigenschaften aller Platzhalterformen auf Seiten, die dieses Master verwenden.
  • In den Eigenschaften der Masterseite werden die allgemeinen Seiteneigenschaften definiert, die von den Layouts übernommen werden.
  • Alle anderen Formen auf der Masterfolie werden unabhängig von ihrem Layout auf allen Folien mit diesem Master angezeigt.
layouts[]

object (Page)

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

string

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

revisionId

string

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

object (Page)

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

  • Platzhalterformen in einem Notizenmaster enthalten die Standardtextstile und -formeigenschaften aller Platzhalterformen in notes pages. Insbesondere enthält die Platzhalterform SLIDE_IMAGE die Miniaturansicht der Folie und die Platzhalterform BODY die Vortragsnotizen.
  • In den Eigenschaften der Hauptseite der Hinweise werden die allgemeinen Seiteneigenschaften definiert, die von allen notes pages übernommen werden.
  • Alle anderen Formen im Notizenmaster werden an allen notes pages-Elementen 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.