Mit der Google Slides API können Sie Präsentations-, Seiten- und Seitenelementdaten 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 Platzhalter verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentations-ID angeben. Sie können den Wert für diese ID der Präsentations-URL entnehmen.
- PAGE_ID: Gibt an, wo Sie die Seitenobjekt-ID angeben. Sie können den Wert hierfür aus der URL oder über eine API-Leseanfrage abrufen.
Diese Beispiele werden als HTTP-Anfragen dargestellt, damit sie sprachneutral sind. Die Beispiele stammen aus dieser Beispielpräsentation, in der 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc
als PRESENTATION_ID angegeben ist. Die PAGE_ID der ersten Folie dieser Präsentation ist ge63a4b4_1_0
.
In den Beispielen hier werden Feldmasken verwendet, um nur bestimmte angeforderte Informationen über die Präsentation, die Folie und das Seitenelement zurückzugeben. Die Verwendung von Feldmasken verbessert auch die Leistung.
Folienobjekt-IDs lesen
Das folgende Codebeispiel für presentations.get
zeigt, wie eine Liste aller Folienobjekt-IDs aus der Präsentation abgerufen wird. Die IDs werden in der Reihenfolge der Präsentation zurückgegeben und können verwendet werden, um in nachfolgenden API-Anfragen bestimmte Folien zu kennzeichnen. Sie können die Objekt-IDs von Master- und Layoutseiten mit fields=masters.objectId
und fields=layout.objectId
auf dieselbe Weise abrufen.
Das folgende Anfrageprotokoll dient zum Lesen von Folienobjekt-IDs:
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" } ] }
Element-Objekt-IDs von einer Seite lesen
Im folgenden Codebeispiel für presentations.pages.get
wird gezeigt, wie Sie eine Liste von Objekt-IDs für alle Seitenelemente auf einer Seite abrufen.
Das folgende Anfrageprotokoll dient zum Lesen von Elementobjekt-IDs von einer Seite:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
Die Antwort besteht aus einem Page
-Objekt mit den angeforderten Objekt-IDs:
{ "pageElements": [ { "objectId": "ge63a4b4_1_5" }, { "objectId": "ge63a4b4_1_6" }, { "objectId": "ge63a4b4_1_7" }, { "objectId": "ge63a4b4_1_8" } ] }
Formelemente auf einer Seite lesen
Im folgenden Codebeispiel für presentations.pages.get
wird gezeigt, wie Sie eine Liste aller Shapes
auf einer Seite abrufen. Sie können andere PageElement
-Typen abrufen, indem Sie sie mit dem Parameter fields
angeben. Beispiel: fields=pageElements(line,table)
gibt nur Informationen zu Seitenelementen line
und table
zurück, sofern auf der Seite Elemente vorhanden sind.
Das folgende Anfrageprotokoll dient zum Lesen von Formelementen aus 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 Klammern kennzeichnen Seitenelemente, die nicht den Formtyp haben. 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 } } } ] } } }, ... ] }