Mit der Google Präsentationen API können Sie Daten zu Präsentationen, Seiten und Seitenelementen lesen. Die Beispiele auf dieser Seite zeigen, wie Sie gängige Lesevorgänge sowohl mit der Methode presentations.get als auch mit der Methode presentations.pages.get ausführen.
In diesen Beispielen werden die folgenden Platzhalter verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentations-ID angeben. Sie finden den Wert für diese ID in der URL der Präsentation.
- PAGE_ID: Gibt an, wo Sie die Seitenobjekt-ID angeben. Sie können den Wert dafür über die URL oder mithilfe einer API-Leseanfrage abrufen.
Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Die Beispiele stammen aus dieser Beispielpräsentation, in der 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc als PRESENTATION_ID verwendet wird. Die 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. Außerdem lässt sich mithilfe von Feldmasken die Leistung verbessern.
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 auf die gleiche Weise mit fields=masters.objectId und fields=layout.objectId abrufen.
Im Folgenden finden Sie das Anfrageprotokoll zum Lesen von Folienobjekt-IDs:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Die Antwort besteht aus einem Presentation-Objekt mit den angeforderten Objekt-IDs:
{
"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 eine Liste der Objekt-IDs für alle Seitenelemente auf einer Seite abgerufen wird.
Im Folgenden finden Sie das Anfrageprotokoll 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 von einer Seite lesen
Im folgenden presentations.pages.get-Codebeispiel wird gezeigt, wie eine Liste aller Shapes auf einer Seite abgerufen wird. Sie können andere PageElement-Typen 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 diese 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 Klammern stehen für Seitenelemente, die nicht dem Typ „Form“ zugewiesen sind. In diesem Fall sind es Seitenelemente vom Typ „Bild“.
{ "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 } } } ] } } }, ... ] }