Mit der Google Slides API können Sie Daten zu Präsentationen, Seiten und Seitenelementen lesen. Die Beispiele auf dieser Seite zeigen, wie Sie gängige Lesevorgänge mit den Methoden presentations.get und presentations.pages.get ausführen.
In diesen Beispielen werden die folgenden Platzhalter verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentations-ID angeben. Den Wert für diese ID finden Sie in der Präsentations-URL.
- PAGE_ID: Gibt an, wo Sie die Seitenobjekt-ID angeben. Sie können den Wert dafür aus der URL oder mit einer API-Leseanfrage abrufen.
Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachneutral zu sein. Die Beispiele stammen aus dieser Beispielpräsentation, deren PRESENTATION_ID 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc ist. Der PAGE_ID 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, Folie und zum Seitenelement zurückzugeben. Die Verwendung von Feldmasken verbessert auch die Leistung.
Objekt-IDs von Folien lesen
Im folgenden presentations.get-Codebeispiel wird gezeigt, wie Sie eine Liste aller Folienobjekt-IDs aus der Präsentation abrufen. Die IDs werden in der Reihenfolge der Folien in der Präsentation zurückgegeben und können verwendet werden, um bestimmte Folien in nachfolgenden API-Anfragen anzugeben. Sie können die Objekt-IDs von Master- und Layoutseiten auf dieselbe Weise abrufen, indem Sie fields=masters.objectId und fields=layout.objectId verwenden.
Das folgende Protokoll wird verwendet, um die IDs von Folienobjekten zu lesen:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Die Antwort besteht aus einem Presentation-Objekt, das die angeforderten Objekt-IDs enthält:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}Elementobjekt-IDs von einer Seite lesen
Im folgenden presentations.pages.get-Codebeispiel wird gezeigt, wie Sie eine Liste von Objekt-IDs für alle Seitenelemente auf einer Seite abrufen.
Das folgende Protokoll wird verwendet, um Elementobjekt-IDs von einer Seite zu lesen:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
Die Antwort besteht aus einem Page-Objekt, das die angeforderten Objekt-IDs enthält:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}Formelemente von einer Seite lesen
Das folgende presentations.pages.get-Codebeispiel zeigt, wie Sie eine Liste aller Shapes auf einer Seite abrufen. Sie können andere PageElement abrufen, indem Sie sie mit dem Parameter fields angeben. fields=pageElements(line,table) gibt beispielsweise nur Informationen zu den Seitenelementen line und table zurück, sofern sie auf der Seite vorhanden sind.
Im Folgenden finden Sie das Anfrageprotokoll zum Lesen von Formelementen von einer Seite:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
Die Antwort besteht aus einem Page-Objekt, das die angeforderten Formelemente enthält. Die leeren geschweiften Klammern geben Seitenelemente an, die nicht vom Formtyp 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 } } } ] } } }, ... ] }