REST Resource: presentations

Ressource: Präsentation

Eine Google Präsentationen-Präsentation.

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

  • Platzhalterformen auf einem Master enthalten die Standardtextstile und Formeigenschaften aller Platzhalterformen auf Seiten, die diesen Master verwenden.
  • Die Eigenschaften der Masterseite 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 unklarer 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 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 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 Formeigenschaften aller Platzhalterformen auf notes pages. Insbesondere enthält eine Platzhalterform vom Typ SLIDE_IMAGE die Folienminiatur und eine Platzhalterform vom Typ BODY 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.

Methoden

batchUpdate

Wendet eine oder mehrere Aktualisierungen auf die Präsentation an.

create

Erstellt eine leere Präsentation mit dem in der Anfrage angegebenen Titel.

get

Ruft die neueste Version der angegebenen Präsentation ab.