Mit der Slides API können Sie Daten zu Präsentationen, Seiten und Seitenelementen lesen. Die Beispiele auf dieser Seite zeigen, wie häufige Lesevorgänge mit den Methoden presentations.get und presentations.pages.get ausgeführt werden.
In diesen Beispielen werden die folgenden Variablen verwendet:
- presentationId: Gibt an, wo Sie die Präsentations-ID angeben. Sie können den Wert für diese ID der Präsentations-URL entnehmen.
- pageId gibt an, wo die Seitenobjekt-ID angegeben wird. Sie können den Wert dafür aus der URL abrufen oder eine API-Leseanfrage verwenden.
Die Beispiele stammen aus dieser Beispielpräsentation, in der 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc als presentationId festgelegt ist. Die pageId der ersten Folie in dieser Präsentation ist ge63a4b4_1_0.
In den Beispielen hier werden Feldmasken verwendet, um nur bestimmte angeforderte Informationen zur Präsentation, zu den Folien und zu Seitenelementen zurückzugeben. Auf diese Weise wird die Leistung verbessert, wenn Feldmasken verwendet werden.
Folienobjekt-IDs lesen
Mit der folgenden Anfrage presentations.get wird eine Liste aller Folienobjekt-IDs aus der Präsentation abgerufen.
Die IDs werden in der Reihenfolge der Folienpräsentation zurückgegeben und können verwendet werden, um bestimmte Folien in nachfolgenden API-Anfragen anzugeben. Die Objekt-IDs der Master- und Layoutseiten können auf dieselbe Weise mit fields=masters.objectId und fields=layout.objectId abgerufen werden.
GET https://slides.googleapis.com/v1/presentations/presentationId?fields=slides.objectId
Die Antwort auf diesen Methodenaufruf ist ein Presentation-Objekt, das die angeforderten Komponenten enthält:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}
Element-Objekt-IDs von einer Seite lesen
Mit der folgenden Anfrage presentations.pages.get wird eine Liste von Objekt-IDs für alle Seitenelemente auf einer Seite abgerufen.
GET https://slides.googleapis.com/v1/presentations/presentationId/pages/pageId?fields=pageElements.objectId
Die Antwort auf diesen Methodenaufruf ist ein Page-Objekt, das die angeforderten Komponenten enthält:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}
Formelemente auf einer Seite lesen
Mit der folgenden Anfrage presentations.pages.get wird eine Liste aller Formelemente auf einer Seite abgerufen. Sie können andere Arten von Seitenelementen abrufen, indem Sie sie mit dem Parameter fields angeben. Beispielsweise gibt fields=pageElements(line,table) nur Informationen zu den Seitenelementen line und table zurück, sofern auf der Seite vorhanden sind.
Das Anfrageprotokoll für dieses Beispiel ist unten dargestellt.
GET https://slides.googleapis.com/v1/presentations/presentationId/pages/pageId?fields=pageElements.shape
Die Antwort auf diesen Methodenaufruf ist ein Page-Objekt, das die angeforderten Komponenten enthält. Die leeren geschweiften Klammern kennzeichnen Seitenelemente, die nicht vom Typ „Form“ sind. In diesem Fall sind es Bildseitenelemente.
{
"pageElements": [
{},
{},
{
"shape": {
"shapeProperties" {
"outline" {
"dashStyle": "SOLID",
"outlineFill": {
"solidFill": {
"alpha": 1,
"color": {
"rgbColor": {}
}
},
},
"propertyState": "NOT_RENDERED",
"weight": {
"magnitude": 9525,
"unit": "EMU"
}
},
"shadow": {
"alignment": "BOTTOM_LEFT",
"alpha": 1,
"blurRadius": {
"unit": "EMU"
},
"color": {
"rgbColor": {}
},
"propertyState": "NOT_RENDERED",
"rotateWithShape": false,
"transform": {
"scaleX": 1,
"scaleY": 1,
"unit": "EMU"
},
"type": "OUTER"
},
"shapeBackgroundFill" : {
"propertyState": "NOT_RENDERED",
"solidFill": {
"alpha": 1,
"color": {
"rgbColor: {
"blue": 1,
"green": 1,
"red": 1
}
}
}
}
},
"shapeType": "TEXT_BOX",
"text": {
"textElements": [
{
"endIndex": 11,
"paragraphMarker": {
"style": {
"alignment": "START",
"direction": "LEFT_TO_RIGHT",
"indentEnd": {
"unit": "PT"
},
"indentFirstLine": {
"unit": "PT"
},
"indentStart": {
"unit": "PT"
},
"lineSpacing": 100,
"spaceAbove": {
"unit": "PT"
},
"spaceBelow": {
"unit": "PT"
},
"spacingMode": "COLLAPSE_LISTS"
}
}
},
{
"endIndex": 11,
"textRun": {
"content": "Baby Album\n",
"style": {
"backgroundColor": {},
"baselineOffset": "NONE",
"bold": false,
"fontFamily": "Arial",
"fontSize": {
"magnitude": 14,
"unit": "PT"
},
"foregroundColor": {
"opaqueColor": {
"rgbColor": {}
}
},
"italic": false,
"smallCaps": false,
"strikethrough": false,
"underline": false
}
}
}
]
}
}
},
...
]
}