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. Die Objekt-IDs, die von Page und PageElement verwendet werden, 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 Versions-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. Das Feld wird nur ausgefüllt, wenn der Nutzer Bearbeitungszugriff auf die Präsentation hat.

Die Revision-ID ist keine fortlaufende Nummer, sondern ein intransparenter String. Das Format der Versions-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Versions-ID ist nur 24 Stunden nach der Rückgabe gültig und kann nicht für mehrere Nutzer verwendet werden. Wenn sich die Überarbeitungs-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 am ID-Format zurückzuführen sein.
pageProperties

object (PageProperties)

Die Eigenschaften der Seite.
Union-Feld properties. Für jeden Seitentyp spezifische Eigenschaften. 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 Properties Nur festlegen, wenn „pageType“ = LAYOUT.
notesProperties

object (NotesProperties)

Gibt bestimmte Eigenschaften an. Wird nur festgelegt, wenn „pageType“ den Wert „NOTES“ hat.
masterProperties

object (MasterProperties)

Bestimmte Properties verwalten Nur festgelegt, wenn „pageType“ = MASTER.

PageType

Der Typ einer Seite.

Enums
SLIDE Eine Folienseite.
MASTER Eine Masterfolienseite.
LAYOUT Eine 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. Die Objekt-IDs, die von google.apps.slides.v1.Page und google.apps.slides.v1.PageElement verwendet werden, haben denselben Namespace.
size

object (Size)

Die Größe des Seitenelements.
transform

object (AffineTransform)

Die Transformation des Seitenelements.

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

Die anfängliche Transformation für die neu erstellte Group ist immer die Identitätstransformation.
title

string

Der Titel des Seitenelements. Wird mit der Beschreibung kombiniert, um den Alt-Text anzuzeigen.

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

string

Die Beschreibung des Seitenelements. Wird mit dem Titel kombiniert, um Alt-Text anzuzeigen.

Das Feld wird für Group-Elemente nicht unterstützt.
Union-Feld element_kind. Die Art des Elements, das dieses Seitenelement darstellt. Jede Nachricht enthält alle Attribute, 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 zu einer Einheit zusammengeführt wurden.
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 Tabellenelement.
wordArt

object (WordArt)

Ein WordArt-Seitenelement.
sheetsChart

object (SheetsChart)

Ein verknüpftes Diagramm, das aus Google Tabellen eingebettet wurde. Unverlinkte Diagramme werden als Bilder dargestellt.
speakerSpotlight

object (SpeakerSpotlight)

Sprecher im Fokus.

Gruppe

Eine PageElement-Art, die eine zusammengeführte Sammlung von Seitenelementen 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 Text wird als Word Art gerendert.

SpeakerSpotlight

Eine PageElement-Art, die einen „Sprecher im Fokus“ darstellt.

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

object (SpeakerSpotlightProperties)

Die Eigenschaften von „Sprecher im Fokus“.

SpeakerSpotlightProperties

Die Eigenschaften der SpeakerSpotlight.

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

object (Outline)

Die Umrisse von „Sprecher im Fokus“. Wenn Sie diese Option nicht festlegen, hat das Element keinen Umriss.
shadow

object (Shadow)

Der Schatten des „Sprechers im Fokus“. Wenn dieser Wert nicht festgelegt ist, hat das Objekt keinen Schatten.

SlideProperties

Die Eigenschaften von Page, die nur für Seiten mit dem Seitentyp „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. Dieses Attribut ist schreibgeschützt.
masterObjectId

string

Die Objekt-ID des Masters, auf dem diese Folie basiert. Dieses Attribut ist schreibgeschützt.
notesPage

object (Page)

Die Notizenseite, die mit dieser Folie verknüpft ist. Damit wird das Erscheinungsbild einer Notizenseite beim Drucken oder Exportieren von Folien mit Sprechernotizen definiert. Eine Notizenseite erbt Eigenschaften von der notes master. Die Platzhalterform vom Typ „TEXT“ auf der Notizenseite enthält die Vortragsnotizen für diese Folie. Die ID dieser Form wird durch das Feld speakerNotesObjectId ermittelt. Die Notizenseite ist schreibgeschützt, mit Ausnahme des Textinhalts und der Stile der Form für die Sprechernotizen. Diese Eigenschaft ist schreibgeschützt.
isSkipped

boolean

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

LayoutProperties

Die Properties von Page sind nur für Seiten mit dem Seitentyp „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 Properties von Page, die nur für Seiten mit dem Seitentyp „NOTES“ relevant sind.

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

string

Die Objekt-ID der Form auf dieser Notizenseite, die die Sprechernotizen für die entsprechende Folie enthält. Die tatsächliche Form ist auf der Notizenseite möglicherweise nicht immer vorhanden. Wenn Sie Text mit dieser Objekt-ID einfügen, wird die Form automatisch erstellt. In diesem Fall hat die tatsächliche Form möglicherweise eine andere Objekt-ID. Bei der Aktion presentations.get oder pages.get wird immer die neueste Objekt-ID zurückgegeben.

MasterProperties

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

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

string

Der für Menschen lesbare Name des Masters.

PageProperties

Die Eigenschaften der Page.

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

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

object (PageBackgroundFill)

Die Hintergrundfüllung der Seite. Wenn diese Option nicht festgelegt ist, wird die Hintergrundfüllung von einer übergeordneten Seite übernommen, falls vorhanden. Wenn die Seite kein übergeordnetes Element hat, wird die Hintergrundfüllung standardmäßig durch die entsprechende Füllung im Editor für Präsentationen ersetzt.
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 übrigen ThemeColorTypes werden ignoriert.

PageBackgroundFill

Die 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)

Der Status des Attributs „background fill“.

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 Ausfüllfelder ignoriert.
Union-Feld kind. Die Art der Hintergrundfüllung. Für kind ist nur einer der folgenden Werte zulässig:
solidFill

object (SolidFill)

Füllung mit einer durchgehenden Farbe
stretchedPictureFill

object (StretchedPictureFill)

Gestreckte Bildfüllung.

StretchedPictureFill

Das gestreckte Bild füllt den Frame aus. Die Seite oder das Seitenelement wird vollständig mit dem angegebenen Bild gefüllt. Das Bild wird auf die Größe des Containers gedehnt.

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

string

Lesen der contentUrl:

Eine URL zu einem Bild mit einer Standardgültigkeitsdauer von 30 Minuten. Diese URL ist mit dem Konto des Antragstellers getaggt. Jeder, der die URL hat, kann auf das Bild zugreifen, als wäre er der ursprüngliche Antragsteller. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Präsentation ändern.

contentUrl schreiben:

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

Die angegebene URL darf maximal 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 einen Designfarbtyp der konkreten Farbe zuordnet, die er darstellt.

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

enum (ThemeColorType)

Der Typ der Designfarbe.
color

object (RgbColor)

Die konkrete Farbe, 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.