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 dem
presentations.get und
presentations.pages.get
.
In diesen Beispielen werden die folgenden Platzhalter verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentation ID fest. Sie können finden Sie den Wert für diese ID in der Präsentations-URL.
- PAGE_ID: Gibt an, wo Sie das Seitenobjekt bereitstellen. ID fest. Sie können die Daten abrufen, den Wert hierfür aus der URL oder mithilfe einer API-Leseanfrage.
Diese Beispiele werden als HTTP-Anfragen dargestellt, damit sie sprachneutral sind. Die
Beispiele aus diesem Beispiel
Präsentation,
mit 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc als
PRESENTATION_ID. Der PAGE_ID des
erste
Folie
in dieser Präsentation ist ge63a4b4_1_0.
In den Beispielen hier werden Feldmasken verwendet, um Bestimmte angeforderte Informationen über die Präsentation, Folie und Seite zurückgeben -Elements. Die Verwendung von Feldmasken verbessert auch die Leistung.
Folienobjekt-IDs lesen
Die folgenden
presentations.get-Code
Das Beispiel zeigt, wie Sie eine Liste aller Folienobjekt-IDs aus dem
zu präsentieren. Die IDs werden in der Reihenfolge der Präsentation zurückgegeben und können
zur Angabe bestimmter Folien in nachfolgenden API-Anfragen. Sie erhalten die
die Objekt-IDs der Master- und Layoutseiten auf die gleiche Weise, wobei
fields=masters.objectId und fields=layout.objectId.
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 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"
}
]
}
Element-Objekt-IDs von einer Seite lesen
Die folgenden
presentations.pages.get
Codebeispiel zeigt, wie eine Liste von Objekt-IDs für alle Seitenelemente abgerufen wird
auf einer Seite.
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
Objekt Page
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
Die folgenden
presentations.pages.get
zeigt das Codebeispiel, wie Sie eine Liste aller
Shapes
auf einer Seite. Sie können weitere
PageElement
Arten angeben, indem Sie sie mit dem Parameter fields angeben. Beispiel:
fields=pageElements(line,table) gibt nur Informationen zurück zu
line und
table
Seitenelemente, sofern auf der Seite 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
Objekt Page
der die angeforderten Formelemente enthält. Die leeren Klammern stehen für Seitenelemente
die nicht dem Typ "Form" entsprechen. 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
}
}
}
]
}
}
},
...
]
}