Interfejs Google Slides API umożliwia odczytywanie danych o prezentacji, stronie i elementach 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 należy podać identyfikator prezentacji. Wartość tego identyfikatora możesz znaleźć w adresie URL prezentacji.
- PAGE_ID—Wskazuje, gdzie należy podać identyfikator obiektu strony. Wartość tej opcji możesz pobrać z adresu URL lub za pomocą żądania odczytu interfejsu API.
Te przykłady są przedstawione jako żądania HTTP, aby były neutralne pod względem języka. Przykłady odczytane z tej prezentacji, która ma 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc jako PRESENTATION_ID. PAGE_ID pierwszego slajdu 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 slajdów. 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
Poniższy przykładowy kod presentations.pages.get pokazuje, jak pobrać listę identyfikatorów obiektów dla wszystkich elementów strony.
Oto protokół żądania odczytywania identyfikatorów obiektów elementów z 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
Poniższy przykładowy kod presentations.pages.get pokazuje, jak pobrać listę wszystkich Shapes na stronie. Inne typy 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 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ź zawiera obiekt Page zawierający żą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
}
}
}
]
}
}
},
...
]
}