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 prüfen, ob sich die Überarbeitung der Präsentation seit dem letzten Lesevorgang 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 Überarbeitungs-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Überarbeitungs-ID ist garantiert nur 24 Stunden lang gültig und kann nicht mit anderen Nutzern geteilt werden. Wenn die Überarbeitungs-ID zwischen Aufrufen unverändert ist, 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 durch interne Faktoren wie Änderungen des ID-Formats verursacht werden.

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 Attribute erforderlich. Für properties ist nur einer der folgenden Werte zulässig:
slideProperties

object (SlideProperties)

Folieneigenschaften Wird nur festgelegt, wenn „pageType“ auf „Folie“ eingestellt ist.

layoutProperties

object (LayoutProperties)

Layoutspezifische Eigenschaften Nur festgelegt, wenn pageType = LAYOUT.

notesProperties

object (NotesProperties)

Gibt bestimmte Attribute an. Wird nur festgelegt, wenn „pageType“ = „NOTES“ ist.

masterProperties

object (MasterProperties)

Masterspezifische Properties. Nur festlegen, wenn pageType = MASTER.

Seitentyp

Der Typ einer Seite.

Enums
SLIDE Eine Folie.
MASTER Eine Masterfolienseite.
LAYOUT Eine Layoutseite.
NOTES Eine Notizseite.
NOTES_MASTER Eine Masterseite in Notes.

Seitenelement

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)
  }
  // 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 hängt von seiner absoluten Transformation ab. Wenn Sie die absolute Transformation berechnen möchten, müssen Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen verketten. Wenn das Seitenelement nicht in einer Gruppe ist, ist die absolute Transformation mit dem Wert in diesem Feld identisch.

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

title

string

Der Titel des Seitenelements. Kombiniert mit einer Beschreibung, um Alt-Text anzuzeigen.

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

description

string

Die Beschreibung des Seitenelements Kombiniert mit Titel, um alternativen Text anzuzeigen.

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

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

object (Group)

Mehrere Seitenelemente, die als eine Einheit verbunden sind

shape

object (Shape)

Eine allgemeine Form.

image

object (Image)

Ein Bildseitenelement.

video

object (Video)

Ein Videoseitenelement.

line

object (Line)

Ein Linienseitenelement.

table

object (Table)

Ein Seitenelement in der Tabelle

wordArt

object (WordArt)

Ein WordArt-Seitenelement.

sheetsChart

object (SheetsChart)

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

Gruppe

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

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

object (PageElement)

Die Sammlung von Elementen in der Gruppe. Die Mindestgröße einer Gruppe ist 2.

WordArt

Eine PageElement-Art, die WordArt darstellt.

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

string

Der Text wird als WordArt gerendert.

Folieneigenschaften

Die Eigenschaften von Page, die nur für Seiten mit „pageType“-Folien 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 Property ist schreibgeschützt.

masterObjectId

string

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

notesPage

object (Page)

Die Notizenseite, mit der diese Folie verknüpft ist. Damit wird die visuelle Darstellung einer Notizenseite beim Drucken oder Exportieren von Folien mit Vortragsnotizen definiert. Eine Notizseite übernimmt Attribute von der notes master. Die Platzhalterform mit dem Text BODY auf der Notizenseite enthält die Vortragsnotizen für diese Folie. Die ID dieser Form wird durch das Feld speakerNotesObjectId identifiziert. Mit Ausnahme des Textinhalts und der Stile der Vortragsnotizen sind sie schreibgeschützt. Diese Property ist schreibgeschützt.

isSkipped

boolean

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

Layout-Properties

Die Eigenschaften von Page sind nur für Seiten mit „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 für Menschen lesbare Name des Layouts.

Hinweise

Die Eigenschaften von Page, die nur für Seiten mit „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 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 kann die tatsächliche Form eine andere Objekt-ID haben. Die Aktion presentations.get oder pages.get gibt immer die neueste Objekt-ID zurück.

Master-Properties

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

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

string

Der für Menschen lesbare Name des Masters.

Seiteneigenschaften

Die Attribute von Page.

Die Seite übernimmt die Eigenschaften der übergeordneten Seite. Je nach Seitentyp ist 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 sie vorhanden ist. Wenn die Seite kein übergeordnetes Element hat, wird für die Hintergrundfüllung im Google Präsentationen-Editor standardmäßig die entsprechende Füllung verwendet.

colorScheme

object (ColorScheme)

Das Farbschema der Seite. Wenn die Richtlinie nicht konfiguriert ist, wird das Farbschema von einer übergeordneten Seite übernommen. Wenn die Seite kein übergeordnetes Element hat, wird für das Farbschema ein Standardfarbschema verwendet, das mit den Standardeinstellungen im Präsentationen-Editor übereinstimmt.

Nur die Betonfarben der ersten 12 ThemeColorTypes können bearbeitet werden. Außerdem kann nur das Farbschema auf Master-Seiten aktualisiert werden. Zum Aktualisieren des Feldes muss ein Farbschema mit Zuordnungen von den ersten 12 ThemeColorTypes zu deren konkreten Farben angegeben werden. Farben für die verbleibenden „ThemeColorTypes“ werden ignoriert.

Seitenhintergrund-Füllung

Die Seitenhintergrundfüllung.

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 der Hintergrundfülleigenschaft.

Wenn Sie die Füllung auf einer Seite aktualisieren, wird dieses Feld implizit auf RENDERED aktualisiert, sofern in derselben Anfrage kein anderer Wert angegeben ist. Wenn eine Seite nicht ausgefüllt 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)

Einfarbig ausgefüllt.

stretchedPictureFill

object (StretchedPictureFill)

Bilderweiterung gestreckt.

Gestrecktes BildFill

Die gestreckte Bildfüllung. Das Seiten- oder Seitenelement ist vollständig mit dem angegebenen Bild ausgefüllt. Das Bild wird so gestreckt, dass es in den Container passt.

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

string

„contentUrl“ lesen:

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, greift praktisch auf das Bild als ursprünglicher Antragsteller zu. Der Zugriff auf das Bild geht möglicherweise verloren, wenn sich die Freigabeeinstellungen der Präsentation ändern.

„contentUrl“ schreiben:

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

Die angegebene URL darf maximal 2 KB lang sein.

size

object (Size)

Die Originalgröße des Bilds. Dieses Feld ist schreibgeschützt.

Farbschema

Die Palette vordefinierter Farben für eine Seite.

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

object (ThemeColorPair)

ThemeColorType und entsprechende Betonfarbenpaare

DesignFarbpaar

Ein Paar, das einen Designfarbtyp der entsprechenden Betonfarbe zuordnet.

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

enum (ThemeColorType)

Die Art der Designfarbe.

color

object (RgbColor)

Die Betonfarbe, die dem Farbtyp des Designs oben entspricht.

Methoden

get

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

getThumbnail

Erstellt eine Miniaturansicht der aktuellen Version der angegebenen Seite in der Präsentation und gibt eine URL zur Miniaturansicht zurück