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)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
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 auf der Seite gerenderten Seitenelemente.
revisionId

string

Nur Ausgabe. Die Revisions-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 undurchsichtiger String. Das Format der Revisions-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Revisions-ID ist nur 24 Stunden nach der Rückgabe gültig und kann nicht für mehrere Nutzer freigegeben werden. Wenn die Überarbeitungs-ID zwischen den Aufrufen unverändert ist, hat sich die Präsentation nicht geändert. Eine geänderte ID (für dieselbe Präsentation und denselben Nutzer) bedeutet 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.
commentAnchors[]

object (CommentAnchor)

Nur Ausgabe. Die auf der Seite vorhandenen Kommentaranker.

comments[]

object (CommentThread)

Nur Ausgabe. Die Kommentarthreads, die der Seite zugeordnet sind. Wird nur ausgefüllt, wenn die Seite über einen GetPageRequest mit einem ausgefüllten commentsViewMode abgerufen wurde. Andernfalls werden Kommentare über GetPresentationRequest in Presentation zurückgegeben.

commentsViewMode

enum (CommentsViewMode)

Nur Ausgabe. Der auf die Seite angewendete Ansichtsmodus für Kommentare. Wird nur ausgefüllt, wenn die Seite über einen GetPageRequest mit einem ausgefüllten commentsViewMode abgerufen wurde.

Eigenschaften, die für jeden Seitentyp spezifisch sind. Für Master sind keine zusätzlichen Eigenschaften erforderlich. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
slideProperties

object (SlideProperties)

Folienbezogene Eigenschaften. Wird nur festgelegt, wenn pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Layoutspezifische Eigenschaften. Wird nur festgelegt, wenn pageType = LAYOUT ist.
notesProperties

object (NotesProperties)

Hinweise zu bestimmten Properties. Wird nur festgelegt, wenn pageType = NOTES.
masterProperties

object (MasterProperties)

Masterspezifische Properties. Wird nur festgelegt, wenn pageType = MASTER.
Ende der sich gegenseitig ausschließenden Felder.

PageType

Der Typ einer Seite.

Enums
SLIDE Eine Folie
MASTER Eine Masterfolie
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
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.

Das 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 verketten. Wenn sich das Seitenelement nicht in einer Gruppe befindet, entspricht seine absolute Transformation dem Wert in diesem Feld.

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

string

Der Titel des Seitenelements. Wird in Kombination mit der Beschreibung verwendet, um 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.
Die Art des Elements, das dieses PageElement darstellt. Jede Nachricht enthält alle Eigenschaften, die für die jeweilige Art von Seitenelement spezifisch sind. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
elementGroup

object (Group)

Eine Sammlung von Seitenelementen, die als eine Einheit zusammengefasst sind.
shape

object (Shape)

Eine allgemeine Form.
image

object (Image)

Ein Bildseitenelement
video

object (Video)

Ein Video-Seitenelement
line

object (Line)

Ein Zeilen-Seitenelement.
table

object (Table)

Ein Tabellenseitenelement.
wordArt

object (WordArt)

Ein WordArt-Seitenelement.
sheetsChart

object (SheetsChart)

Ein verknüpftes Diagramm, das aus Google Sheets eingebettet wurde. Nicht verknüpfte Diagramme werden als Bilder dargestellt.
speakerSpotlight

object (SpeakerSpotlight)

Sprecher im Fokus
Ende der sich gegenseitig ausschließenden Felder.

Gruppe

Ein PageElement-Typ, der eine zusammengeführte 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 beträgt 2.

WordArt

Ein PageElement-Typ, der WordArt darstellt.

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

string

Der als WordArt gerenderte Text.

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 des SpeakerSpotlight.

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

object (Outline)

Die Umrisslinie des Sprecher-im-Fokus-Objekts. Wenn sie nicht festgelegt ist, hat sie keinen Umriss.
shadow

object (Shadow)

Der Schatten des Sprecher-Spotlights. Wenn nicht festgelegt, hat das Element keinen Schatten.

SlideProperties

Die Eigenschaften 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 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 Erscheinungsbild einer Notizenseite beim Drucken oder Exportieren von Folien mit Vortragsnotizen festgelegt. Eine Notizenseite erbt Eigenschaften von der notes master. Die Platzhalterform 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 Formatierungen der Form für die Vortragsnotizen. 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 für Menschen 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 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 aktuelle Objekt-ID zurückgegeben.

MasterProperties

Die Properties 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.

PageProperties

Die Eigenschaften des Page.

Die Seite übernimmt die Eigenschaften 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 nicht festgelegt, wird die Hintergrundfüllung von einer übergeordneten Seite übernommen, sofern vorhanden. Wenn die Seite kein übergeordnetes Element hat, wird standardmäßig die entsprechende Füllung im Slides-Editor verwendet.
colorScheme

object (ColorScheme)

Das Farbschema der Seite. Wenn keine Angabe erfolgt, wird das Farbschema von einer übergeordneten Seite übernommen. Wenn die Seite kein übergeordnetes Element hat, wird ein standardmäßiges Farbschema für Google-Präsentationen verwendet, das den Standardeinstellungen im Google-Präsentationen-Editor entspricht.

Nur die konkreten Farben 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 12 ThemeColorTypes zu ihren konkreten Farben angegeben werden. Farben für die verbleibenden ThemeColorTypes werden ignoriert.

PageBackgroundFill

Die Hintergrundfüllung der Seite.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
Felder
propertyState

enum (PropertyState)

Der Status des Attributs „background-fill“.

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 Sie keine Füllung für eine Seite wünschen, legen Sie für dieses Feld NOT_RENDERED fest. In diesem Fall werden alle anderen in derselben Anfrage festgelegten Füllfelder ignoriert.
Die Art der Hintergrundfüllung. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
solidFill

object (SolidFill)

Einfarbige Füllung.
stretchedPictureFill

object (StretchedPictureFill)

Gestreckte Bildfüllung.
Ende der sich gegenseitig ausschließenden Felder.

StretchedPictureFill

Die gestreckte Bildfüllung. Die Seite oder das Seitenelement ist 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 lesen:

Eine URL zu einem Bild mit einer Standard-Gü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 sein, dürfen nicht mehr als 25 Megapixel haben und 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)

Der ThemeColorType und die entsprechenden konkreten Farbkombinationen.

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 Typ der Designfarbe entspricht.

CommentAnchor

Enthält eine Liste aller Standorte in einem Page, die über denselben anchorId an einem CommentThread verankert sind. Mehrere separate Anker können auf denselben Ort verweisen, entweder innerhalb eines Page oder auf verschiedenen Seiten.

JSON-Darstellung 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Felder
anchorId

string

Nur Ausgabe. Die eindeutige ID des Kommentarankers.
objectAnchors[]

object (ObjectAnchor)

Nur Ausgabe. Alle objekt-ID-basierten Positionen auf einer Seite, die sich auf die Anker-ID beziehen.

ObjectAnchor

Stellt Kommentarankerdaten dar, die mit einem Google-Präsentationen-Objekt verknüpft sind, z. B. Page oder PageElement.

JSON-Darstellung 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
Felder
objectId

string

Nur Ausgabe. Die Seite oder das Seitenelement, an dem der Kommentarthread verankert ist.
Nur Ausgabe. Die Textbereiche innerhalb des Seitenelements, an dem der Kommentarthread verankert ist. Ist leer, wenn der Kommentaranker für die gesamte Seite oder das gesamte Seitenelement und nicht für einen Textbereich innerhalb des Elements gilt. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
shapeTextAnchors

object (ShapeTextAnchors)

Wird für Shapes ausgefüllt, für die Kommentare an Textbereiche im [Text][google.apps.slides.v1.Shape.TextContent] der Form angehängt sind.
tableCellAnchors

object (TableCellAnchors)

Wird für Tables ausgefüllt, für die Kommentare an Textbereiche in einer oder mehreren Zellen der Tabelle angehängt sind.
Ende der sich gegenseitig ausschließenden Felder.

ShapeTextAnchors

Stellt Textbereiche in einer Form dar, die von einem Kommentaranker abgedeckt werden.

JSON-Darstellung 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Felder
ranges[]

object (TextRange)

Eine Liste der Textbereiche, die vom Kommentaranker abgedeckt werden.

TextRange

Gibt einen zusammenhängenden Textbereich innerhalb der text einer Form oder Tabellenzelle an.

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer
}
Felder
startIndex

integer

Der nullbasierte Index des Anfangsbereichs. Dieses Feld ist ein Int32Value, um zukünftige Anwendungsfälle mit offenen Bereichen zu berücksichtigen.
endIndex

integer

Der nullbasierte Index des Endes des Bereichs. Dieses Feld ist ein Int32Value, um zukünftige Anwendungsfälle mit offenen Bereichen zu berücksichtigen.

TableCellAnchors

Stellt Tabellenzellbereiche in einer Tabelle dar, die von einem Kommentaranker abgedeckt werden.

JSON-Darstellung 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Felder
cellRanges[]

object (TableCellTextRanges)

Eine Liste aller Tabellenzellen in einer Tabelle, deren Text vom Anker in der Tabelle abgedeckt wird.

TableCellTextRanges

Stellt Textbereiche in einer Tabellenzelle dar, die von einem Kommentaranker abgedeckt werden.

JSON-Darstellung 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Felder
cellLocation

object (TableCellLocation)

Die Position der Tabellenzelle.
ranges[]

object (TextRange)

Eine Liste aller Textbereiche, die vom Anker in dieser Zelle abgedeckt werden.

Methoden

get

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

getThumbnail

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