Interfejs API Prezentacji Google umożliwia odczytywanie danych prezentacji, strony i elementów strony.
na tej stronie pokazujemy, jak wykonywać typowe operacje odczytu przy użyciu
presentations.get i
presentations.pages.get
.
W poniższych przykładach używane są następujące zmienne:
- PRESENTATION_ID – wskazuje, gdzie podajesz atrybuty prezentacja Identyfikator. Dostępne opcje wartość tego identyfikatora można znaleźć w adresie URL prezentacji.
- PAGE_ID – wskazuje miejsce, w którym podajesz obiekt strony. Identyfikator. Możesz pobrać tę wartość 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 przeczytane z tego przykładu
prezentacja,
, w której wymiarem głównym jest 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc
PRESENTATION_ID PAGE_ID
pierwszy
slajd
w tej prezentacji to ge63a4b4_1_0.
W tym przykładzie maski pola są używane tylko do zwraca określone żądane informacje o prezentacji, slajdzie i stronie. . Użycie masek pól również zwiększa wydajność.
Odczytywanie identyfikatorów obiektów slajdów
Poniżej
Kod presentations.get
pokazuje, jak pobrać listę wszystkich identyfikatorów obiektów slajdów z
prezentacji. Identyfikatory są zwracane w kolejności prezentacji slajdów i mogą być
służy do wskazywania konkretnych slajdów w kolejnych żądaniach interfejsu API. Możesz uzyskać
identyfikatorów obiektów na stronie głównej i stronie układu w ten sam sposób,
fields=masters.objectId i fields=layout.objectId.
Oto protokół żądania do odczytu identyfikatorów obiektów slajdów:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Odpowiedź składa się z
Presentation
obiekt zawierający żądane identyfikatory:
{
"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żej
presentations.pages.get
przykładowy kod pokazuje, 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ź składa się z
Page obiekt
, który zawiera żądane identyfikatory:
{
"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żej
presentations.pages.get
przykładowy kod pokazuje, jak pobrać listę wszystkich
Shapes
na stronie. Możesz pobrać inne dane,
PageElement
rodzaje, określając je za pomocą parametru fields. Przykład:
fields=pageElements(line,table) zwraca tylko informacje o
line i
table
jeśli na stronie są jakieś elementy strony.
Poniżej znajduje się protokół żądania do odczytu 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
Page obiekt
które zawierają żądane elementy kształtu. Puste nawiasy klamrowe wskazują elementy strony
które nie mają typu kształtu; w tym przypadku są to elementy strony graficznej.
{
"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
}
}
}
]
}
}
},
...
]
}