REST Resource: presentations.pages

Ressource: Seite

Eine Seite in einer Präsentation.

JSON-Darstellung
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Felder
objectId

string

Die Objekt-ID für diese Seite. Von Page und PageElement verwendete Objekt-IDs haben denselben Namespace.

pageType

enum (PageType)

Der Typ der Seite.

pageElements[]

object (PageElement)

Die Seitenelemente, die auf der Seite gerendert werden.

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 intransparenter String. Das Format der Überarbeitungs-ID kann sich im Laufe der Zeit ändern. 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.

pageProperties

object (PageProperties)

Die Eigenschaften der Seite.

Union-Feld properties. Eigenschaften, die für jeden Seitentyp spezifisch sind. Für Master sind keine zusätzlichen Eigenschaften erforderlich. Für properties ist nur einer der folgenden Werte zulässig:
slideProperties

object (SlideProperties)

Folienspezifische Eigenschaften. Nur festgelegt, wenn pageType = slide.

layoutProperties

object (LayoutProperties)

Layoutspezifische Eigenschaften Nur festgelegt, wenn pageType = LAYOUT.

notesProperties

object (NotesProperties)

Gibt bestimmte Eigenschaften an. Nur festgelegt, wenn pageType = NOTES.

masterProperties

object (MasterProperties)

Master-spezifische Eigenschaften. Nur festgelegt, wenn pageType = MASTER.

PageType

Der Typ einer Seite.

Enums
SLIDE Eine Folienseite.
MASTER Eine Masterfolienseite.
LAYOUT Layoutseite
NOTES Eine Notizenseite.
NOTES_MASTER Eine Masterseite für Notizen.

PageElement

Ein visuelles Element, das auf einer Seite gerendert wird.

JSON-Darstellung
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
Felder
objectId

string

Die Objekt-ID für dieses Seitenelement. Von google.apps.slides.v1.Page und google.apps.slides.v1.PageElement verwendete Objekt-IDs haben denselben Namespace.

size

object (Size)

Die Größe des Seitenelements.

transform

object (AffineTransform)

Die Transformation des Seitenelements.

Die visuelle Darstellung des Seitenelements wird durch seine absolute Transformation bestimmt. Um die absolute Transformation zu berechnen, verketten Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen. Wenn sich das Seitenelement nicht in einer Gruppe befindet, entspricht seine absolute Transformation dem Wert in diesem Feld.

Die erste Transformation für die neu erstellte Group ist immer die Identitätstransformation.

title

string

Der Titel des Seitenelements. In Kombination mit der Beschreibung, um Alt-Text anzuzeigen.

Das Feld wird für Group-Elemente nicht unterstützt.

description

string

Die Beschreibung des Seitenelements. In Kombination mit dem Titel, um Alt-Text anzuzeigen.

Das Feld wird für Group-Elemente nicht unterstützt.

Union-Feld element_kind. Die Art des Elements, das dieses PageElement repräsentiert. Jede Nachricht enthält jegliche Eigenschaften, die für diese Art von Seitenelement spezifisch sind. Für element_kind ist nur einer der folgenden Werte zulässig:
elementGroup

object (Group)

Eine Sammlung von Seitenelementen, die als eine Einheit verbunden sind.

shape

object (Shape)

Eine generische Form.

image

object (Image)

Ein Bildseitenelement.

video

object (Video)

Ein Videoseitenelement.

line

object (Line)

Ein Linienseitenelement.

table

object (Table)

Ein Tabellenseitenelement.

wordArt

object (WordArt)

Ein WordArt-Seitenelement.

sheetsChart

object (SheetsChart)

Ein verknüpftes Diagramm aus Google Tabellen. Nicht verknüpfte Diagramme werden als Bilder dargestellt.

speakerSpotlight

object (SpeakerSpotlight)

Sprecher im Fokus.

Gruppe

Eine PageElement-Art, die eine verknüpfte Sammlung von PageElements darstellt.

JSON-Darstellung
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Felder
children[]

object (PageElement)

Die Sammlung der Elemente in der Gruppe. Die Mindestgröße einer Gruppe beträgt 2.

WordArt

Die Art PageElement, die WordArt darstellt.

JSON-Darstellung
{
  "renderedText": string
}
Felder
renderedText

string

Der als WordArt dargestellte Text.

SpeakerSpotlight

Die Art PageElement, die „Sprecher im Fokus“ darstellt.

JSON-Darstellung
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Felder
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Die Eigenschaften von „Sprecher im Fokus“.

SpeakerSpotlightProperties

Die Attribute von SpeakerSpotlight.

JSON-Darstellung
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Felder
outline

object (Outline)

Die Umrisse des „Sprecher im Fokus“. Wenn die Richtlinie nicht konfiguriert ist, hat sie keine Struktur.

shadow

object (Shadow)

Der Schatten von „Sprecher im Fokus“ Wenn nichts festgelegt ist, gibt es keinen Schatten.

SlideProperties

Die Eigenschaften von Page, die nur für Seiten mit dem pageType slide relevant sind.

JSON-Darstellung
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Felder
layoutObjectId

string

Die Objekt-ID des Layouts, auf dem diese Folie basiert. Diese Eigenschaft ist schreibgeschützt.

masterObjectId

string

Die Objekt-ID des Masters, auf dem diese Folie basiert. Diese Eigenschaft ist schreibgeschützt.

notesPage

object (Page)

Die Notizenseite, mit der diese Folie verknüpft ist. Damit wird das visuelle Erscheinungsbild einer Notizenseite definiert, wenn Folien mit Vortragsnotizen gedruckt oder exportiert werden. Eine Notizenseite übernimmt Eigenschaften von notes master. Der Platzhalter mit dem Typ BODY auf der Notizenseite enthält die Vortragsnotizen für diese Folie. Die ID dieser Form wird durch das Feld speakerNotesObjectId angegeben. Die Notizenseite ist schreibgeschützt, mit Ausnahme des Textinhalts und der Stile der Vortragsnotizen-Form. Diese Eigenschaft ist schreibgeschützt.

isSkipped

boolean

Gibt an, ob die Folie im Präsentationsmodus übersprungen wird. Die Standardeinstellung ist "false".

LayoutProperties

Die Eigenschaften von Page sind nur für Seiten mit dem pageType LAYOUT relevant.

JSON-Darstellung
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Felder
masterObjectId

string

Die Objekt-ID des Masters, auf dem dieses Layout basiert.

name

string

Der Name des Layouts.

displayName

string

Der visuell lesbare Name des Layouts.

NotesProperties

Die Eigenschaften von Page, die nur für Seiten mit dem pageType NOTES relevant sind.

JSON-Darstellung
{
  "speakerNotesObjectId": string
}
Felder
speakerNotesObjectId

string

Die Objekt-ID der Form auf dieser Notizenseite, die die Vortragsnotizen für die entsprechende Folie enthält. Die eigentliche Form ist möglicherweise nicht immer auf der Notizenseite zu sehen. Wenn Sie Text mit dieser Objekt-ID einfügen, wird die Form automatisch erstellt. In diesem Fall kann die eigentliche Form eine andere Objekt-ID haben. Die Aktion presentations.get oder pages.get gibt immer die neueste Objekt-ID zurück.

MasterProperties

Die Eigenschaften von Page, die nur für Seiten mit dem pageType MASTER relevant sind.

JSON-Darstellung
{
  "displayName": string
}
Felder
displayName

string

Der visuell lesbare Name des Masters.

PageProperties

Die Attribute von Page.

Die Seite übernimmt die Eigenschaften der übergeordneten Seite. Je nach Seitentyp wird die Hierarchie entweder in SlideProperties oder in LayoutProperties definiert.

JSON-Darstellung
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Felder
pageBackgroundFill

object (PageBackgroundFill)

Die Hintergrundfüllung der Seite. Wenn die Richtlinie nicht konfiguriert ist, wird die Hintergrundfüllung von einer übergeordneten Seite übernommen, sofern vorhanden. Wenn die Seite kein übergeordnetes Element hat, wird die Hintergrundfüllung im Präsentationen-Editor standardmäßig mit der entsprechenden Füllung ausgefüllt.

colorScheme

object (ColorScheme)

Das Farbschema der Seite. Wenn kein Wert festgelegt ist, wird das Farbschema von einer übergeordneten Seite übernommen. Wenn es für die Seite kein übergeordnetes Element gibt, wird für das Farbschema das Standardfarbschema von Google Präsentationen verwendet, das den Standardeinstellungen des Präsentationen-Editors entspricht.

Nur die Betonfarben der ersten 12 ThemeColorTypes können bearbeitet werden. Außerdem kann nur das Farbschema auf Master-Seiten aktualisiert werden. Um das Feld zu aktualisieren, muss ein Farbschema mit Zuordnungen aller ersten zwölf ThemeColorTypes zu ihren Betonfarben angegeben werden. Farben für die verbleibenden ThemeColorTypes werden ignoriert.

PageBackgroundFill

Hintergrundfüllung der Seite.

JSON-Darstellung
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Felder
propertyState

enum (PropertyState)

Status der Hintergrundfüllung.

Durch das Aktualisieren der Füllung auf einer Seite wird dieses Feld implizit in RENDERED aktualisiert, es sei denn, in derselben Anfrage wird ein anderer Wert angegeben. Wenn auf einer Seite keine Füllung angezeigt werden soll, legen Sie dieses Feld auf NOT_RENDERED fest. In diesem Fall werden alle anderen in derselben Anfrage festgelegten Füllfelder ignoriert.

Union-Feld kind. Die Art der Hintergrundfüllung. Für kind ist nur einer der folgenden Werte zulässig:
solidFill

object (SolidFill)

Vollfarbige Füllung.

stretchedPictureFill

object (StretchedPictureFill)

Gestreckte Bildfüllung.

StretchedPictureFill

Die gestreckte Bildfüllung. Die Seite oder das Seitenelement wird vollständig mit dem angegebenen Bild gefüllt. Das Bild wird so gestreckt, dass es in den Container passt.

JSON-Darstellung
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Felder
contentUrl

string

contentUrl auslesen:

Eine URL zu einem Bild mit einer Standardlebensdauer von 30 Minuten. Diese URL ist mit dem Konto des Antragstellers getaggt. Jeder, der über die URL verfügt, kann als ursprünglicher Anforderer auf das Bild zugreifen. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Präsentation ändern.

So schreiben Sie die contentUrl:

Das Bild wird einmal beim Einfügen abgerufen und eine Kopie wird für die Anzeige in der Präsentation gespeichert. Bilder müssen kleiner als 50 MB und nicht größer als 25 Megapixel sein. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.

Die bereitgestellte URL darf höchstens 2 KB lang sein.

size

object (Size)

Die ursprüngliche Größe der Bildfüllung. Dieses Feld ist schreibgeschützt.

ColorScheme

Die Palette vordefinierter Farben für eine Seite.

JSON-Darstellung
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Felder
colors[]

object (ThemeColorPair)

ThemeColorType und entsprechende Betonfarbpaare

ThemeColorPair

Ein Paar, das den Farbtyp eines Designs der jeweiligen Betonfarbe zuordnet.

JSON-Darstellung
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Felder
type

enum (ThemeColorType)

Der Typ der Designfarbe.

color

object (RgbColor)

Die Betonfarbe, die dem oben genannten Farbtyp des Designs entspricht.

Methoden

get

Ruft die neueste Version der angegebenen Seite in der Präsentation ab.

getThumbnail

Generiert eine Miniaturansicht der neuesten Version der angegebenen Seite in der Präsentation und gibt eine URL zur Miniaturansicht zurück.