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 von Page und PageElement verwendeten Objekt-IDs 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äsentationsüberarbeitung 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 Überarbeitungs-ID ist nach der Rückgabe nur 24 Stunden lang gültig und kann nicht für andere Nutzer freigegeben werden. Wenn sich die Überarbeitungs-ID zwischen den Aufrufen nicht ändert, bleibt die Präsentation unverä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.

pageProperties

object (PageProperties)

Die Eigenschaften der Seite.

Union-Feld properties. Spezifische Eigenschaften für jeden Seitentyp. 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 ist.

layoutProperties

object (LayoutProperties)

Layoutspezifische Eigenschaften. Nur festlegen, wenn pageType = LAYOUT ist.

notesProperties

object (NotesProperties)

Schreibt bestimmte Eigenschaften auf. Nur festgelegt, wenn pageType = NOTES.

masterProperties

object (MasterProperties)

Masterspezifische Properties. 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 Notizen-Master-Seite.

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

Objekt-ID für dieses Seitenelement Die von google.apps.slides.v1.Page und google.apps.slides.v1.PageElement verwendeten 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. Zur Berechnung der absoluten Transformation 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 anfängliche Transformation für die neu erstellte Group ist immer die Identitätstransformation.

title

string

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

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

description

string

Die Beschreibung des Seitenelements. Kombiniert mit Titel zur Anzeige von Alt-Text.

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 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 zu einem einzigen Element 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 Tabellenseitenelement.

wordArt

object (WordArt)

Ein WordArt-Seitenelement.

sheetsChart

object (SheetsChart)

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

speakerSpotlight

object (SpeakerSpotlight)

Sprecher im Fokus.

Gruppe

Eine PageElement-Art, die eine zusammengeführte Sammlung von PageElements darstellt.

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

object (PageElement)

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 als WordArt gerenderte Text.

SpeakerSpotlight

Eine PageElement-Art, die eine 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)

Der Umriss der Funktion „Sprecher im Fokus“. Wenn die Richtlinie nicht konfiguriert ist, gibt es keinen Umriss.

shadow

object (Shadow)

Der Schatten von „Sprecher im Fokus“. Ist die Richtlinie nicht konfiguriert, gibt es keinen Schatten.

SlideProperties

Die Attribute von Page, die nur für Seiten mit 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 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. Sie definiert das visuelle Erscheinungsbild einer Notizenseite beim Drucken oder Exportieren von Folien mit Vortragsnotizen. Eine Notizenseite übernimmt die Eigenschaften von notes master. Die Platzhalterform mit dem Typ BODY auf der Notizenseite enthält die Vortragsnotizen für diese Folie. Die ID dieser Form ist am Feld speakerNotesObjectId zu erkennen. Mit Ausnahme des Textinhalts und der Stile der Vortragsnotizenform ist die Notizenseite schreibgeschützt. Diese Property 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 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 pageType NOTES relevant sind.

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

string

Objekt-ID der Form auf dieser Notizenseite, die die Vortragsnotizen für die entsprechende Folie enthält Die tatsächliche Form ist möglicherweise nicht immer auf der Notizenseite vorhanden. Wenn Sie Text mit dieser Objekt-ID einfügen, wird automatisch die Form 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.

MasterProperties

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

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

string

Der visuell lesbare Name der Master-Instanz.

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 Option nicht konfiguriert ist, wird die Hintergrundfüllung von einer übergeordneten Seite übernommen, sofern vorhanden. Wenn die Seite kein übergeordnetes Element hat, wird als Hintergrundfüllung standardmäßig die entsprechende Füllung im Präsentationen-Editor 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 das Standardfarbschema von Google Präsentationen verwendet, das den Standardeinstellungen im Google Präsentationen-Editor entspricht.

Nur die Betonfarben der ersten 12 ThemeColorType können bearbeitet werden. Außerdem kann nur das Farbschema auf Master-Seiten aktualisiert werden. Zum Aktualisieren des Felds muss ein Farbschema angegeben werden, das Zuordnungen von allen ersten zwölf ThemeColorTypes zu ihren Betonfarben enthält. Farben für die verbleibenden ThemeColorTypes werden ignoriert.

PageBackgroundFill

Die Füllung des Seitenhintergrunds.

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

Beim Aktualisieren der Füllung auf einer Seite wird dieses Feld implizit in RENDERED aktualisiert, sofern nicht ein anderer Wert in derselben Anfrage angegeben wird. Wenn eine Seite keine Füllung erhalten soll, legen Sie dieses Feld auf NOT_RENDERED fest. In diesem Fall werden alle anderen Füllfelder in derselben Anfrage 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 Behälter 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. Jede Person, die über die URL verfügt, greift effektiv als der ursprüngliche Antragsteller auf das Bild zu. Möglicherweise verlieren Sie den Zugriff auf das Bild, wenn sich die Freigabeeinstellungen der Präsentation ändern.

Schreiben der contentUrl:

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

Die angegebene 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 Beton-Farbpaare.

ThemeColorPair

Ein Paar, das der dargestellten Betonfarbe einen Farbtyp des Designs zuordnet.

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

enum (ThemeColorType)

Der Typ 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

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