Interfejs Google Slides API umożliwia odczytywanie danych prezentacji, stron i elementów stron. Przykłady na tej stronie pokazują, jak wykonywać typowe operacje odczytu za pomocą metod presentations.get i presentations.pages.get.
W tych przykładach użyto tych wartości zastępczych:
- PRESENTATION_ID– wskazuje, gdzie podajesz identyfikator prezentacji. Wartość tego identyfikatora znajdziesz w adresie URL prezentacji.
- PAGE_ID– wskazuje, gdzie podajesz identyfikator obiektu strony. Wartość tego parametru możesz pobrać z adresu URL lub za pomocą żądania odczytu interfejsu API.
Przykłady te są przedstawione jako żądania HTTP, aby były niezależne od języka. Przykłady pochodzą z tej prezentacji, która ma 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc jako swój PRESENTATION_ID. PAGE_ID pierwszego slajdu w tej prezentacji to ge63a4b4_1_0.
W przykładach użyto masek pól, aby zwracać tylko określone informacje o prezentacji, slajdzie i elemencie strony. Używanie masek pól poprawia też wydajność.
Odczytywanie identyfikatorów obiektów slajdu
Poniższy przykładowy kod presentations.get pokazuje, jak pobrać listę wszystkich identyfikatorów obiektów slajdów z prezentacji. Identyfikatory są zwracane w kolejności slajdów w prezentacji i mogą być używane do wskazywania konkretnych slajdów w kolejnych żądaniach interfejsu API. Identyfikatory obiektów stron wzorcowych i układów możesz uzyskać w ten sam sposób, używając fields=masters.objectId i fields=layout.objectId.
Oto protokół żądania odczytu identyfikatorów obiektów slajdów:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Odpowiedź składa się z obiektu Presentation zawierającego żądane identyfikatory obiektów:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}Odczytywanie identyfikatorów obiektów elementów ze strony
Poniższy przykładowy kod presentations.pages.get pokazuje, jak pobrać listę identyfikatorów obiektów wszystkich elementów strony.
Poniżej przedstawiamy protokół żądania odczytywania identyfikatorów obiektów elementów ze strony:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
Odpowiedź składa się z obiektu Page zawierającego żądane identyfikatory obiektów:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}Odczytywanie elementów kształtu ze strony
Poniższy przykładowy kod presentations.pages.get pokazuje, jak pobrać listę wszystkich Shapes na stronie. Inne rodzaje PageElement możesz pobrać, określając je za pomocą parametru fields. Na przykład fields=pageElements(line,table) zwraca tylko informacje o elementach strony line i table, jeśli znajdują się one na stronie.
Oto protokół żądania odczytywania elementów kształtu ze strony:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
Odpowiedź składa się z obiektu Page zawierającego żądane elementy kształtu. Puste nawiasy klamrowe wskazują elementy strony, które nie są elementami kształtu. W tym przypadku są to elementy strony z obrazem.
{ "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 } } } ] } } }, ... ] }