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, deren PRESENTATION_ID 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc ist. 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
Im folgenden presentations.get-Codebeispiel wird gezeigt, wie eine Liste aller Folienobjekt-IDs aus der Präsentation abgerufen wird. 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 von Master- und Layoutseiten können Sie 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 ist das Anfrageprotokoll zum Lesen von Elementobjekt-IDs von einer Seite aufgeführt:
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-Arten 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 mit den angeforderten Formelementen. 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 } } } ] } } }, ... ] }