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 auf der Seite gerenderten Seitenelemente.
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. 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 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 Properties 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 Wird nur festgelegt, wenn „pageType“ = LAYOUT.
notesProperties

object (NotesProperties)

Notizen zu bestimmten Properties. Nur festgelegt, wenn „pageType“ = „NOTES“.
masterProperties

object (MasterProperties)

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

PageType

Der Typ einer Seite.

Enums
SLIDE Eine Folienseite.
MASTER Eine Masterfolienseite.
LAYOUT Eine Layoutseite.
NOTES Eine Notizseite.
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 werden.
shape

object (Shape)

Eine generische Form.
image

object (Image)

Ein Bildseitenelement.
video

object (Video)

Ein Element auf einer Videoseite.
line

object (Line)

Ein Element auf einer Linienseite.
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

Eine PageElement-Art, die Word Art 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 des Sprechers 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 angegeben. Die Notizenseite ist schreibgeschützt, mit Ausnahme des Textinhalts und der Stile der Form für die Sprechernotizen. Dieses Attribut ist schreibgeschützt.
isSkipped

boolean

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 für Menschen 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 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 hat die tatsächliche Form möglicherweise eine andere Objekt-ID. Die Aktion presentations.get oder pages.get gibt immer die neueste Objekt-ID zurück.

MasterProperties

Die Properties von Page, die nur für Seiten mit dem Seitentyp „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 keine Farbe festgelegt ist, wird das Farbschema von einer übergeordneten Seite übernommen. Wenn die Seite keine übergeordnete Seite hat, wird das Standardfarbschema von Google Präsentationen verwendet, das den Standardfarben im Editor von Google Präsentationen entspricht.

Nur die konkreten Farben der ersten 12 ThemeColorTypes sind bearbeitbar. Außerdem kann nur das Farbschema auf Master-Seiten aktualisiert werden. Zum Aktualisieren des Felds muss ein Farbschema mit Zuordnungen aller ersten 12 ThemeColorTypes zu ihren konkreten Farben 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 „Hintergrundfüllung“.

Wenn Sie die Füllung auf einer Seite aktualisieren, wird dieses Feld implizit auf RENDERED aktualisiert, es sei denn, in derselben Anfrage wird ein anderer Wert angegeben. Wenn eine Seite nicht ausgefüllt werden soll, setzen Sie dieses Feld auf NOT_RENDERED. 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 Volltonfarbe
stretchedPictureFill

object (StretchedPictureFill)

Bild wird gestreckt, um den Frame zu füllen.

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 Anfragenden 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 beim Einfügen einmal abgerufen und eine Kopie wird zur 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 Originalgröße der Bildfüllung. Dieses Feld ist schreibgeschützt.

ColorScheme

Die Palette der vordefinierten Farben für eine Seite.

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

object (ThemeColorPair)

Der „ThemeColorType“ und die entsprechenden konkreten Farbpaare.

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

 Er generiert eine Miniaturansicht der neuesten Version der angegebenen Seite in der Präsentation und gibt eine URL zum Miniaturbild zurück.