Interfejs API Prezentacji Google umożliwia odczytywanie danych prezentacji, strony i elementów strony. 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 możesz znaleźć w adresie URL prezentacji.
- PAGE_ID—Wskazuje, gdzie należy podać identyfikator obiektu strony. Wartość tę można pobrać z adresu URL lub za pomocą żądania odczytu interfejsu API.
Te przykłady są prezentowane jako żądania HTTP bez względu na język. Przykłady odczytane z tej przykładowej prezentacji, dla której 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc to PRESENTATION_ID. PAGE_ID na pierwszym slajdzie w tej prezentacji to ge63a4b4_1_0.
Przykłady wykorzystują maski pól, aby zwracać tylko określone informacje o prezentacji, slajdzie i elemencie strony. Używanie masek pól również poprawia wydajność.
Odczytywanie identyfikatorów obiektów slajdów
Poniższy przykładowy kod presentations.get pokazuje, jak pobrać z prezentacji listę wszystkich identyfikatorów obiektów slajdu. Identyfikatory są zwracane w kolejności prezentacji slajdów i można ich używać do wskazywania konkretnych slajdów w kolejnych żądaniach interfejsu API. Identyfikatory obiektów stron głównych i stron z układem możesz uzyskać w ten sam sposób, używając wartości 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ź zawiera obiekt Presentation zawierający żą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
Z przykładowego kodu presentations.pages.get dowiesz się, jak pobrać listę identyfikatorów obiektów dla wszystkich elementów strony na stronie.
Protokół żądania odczytuje identyfikatory obiektów elementów ze strony:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
Odpowiedź zawiera obiekt Page zawierający żą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
Z przykładowego kodu presentations.pages.get dowiesz się, jak pobrać listę wszystkich elementów Shapes na stronie. Możesz pobrać inne rodzaje rodzaju PageElement, 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 takie występują.
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. Pusty nawias oznacza elementy strony, które nie są kształtami. 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 } } } ] } } }, ... ] }