API Google Slides позволяет считывать данные презентации, страницы и элементов страницы. В примерах на этой странице показано, как выполнять распространенные операции чтения, используя presentations.get presentations.pages.get .
В этих примерах используются следующие заполнители:
- PRESENTATION_ID —Указывает, где вы предоставляете идентификатор презентации . Вы можете узнать значение этого идентификатора по URL-адресу презентации.
- PAGE_ID —Указывает, где вы предоставляете идентификатор объекта страницы . Вы можете получить это значение по URL-адресу или с помощью запроса на чтение API.
Эти примеры представлены в виде HTTP-запросов, которые не зависят от языка. Примеры взяты из этого примера презентации , в котором PRESENTATION_ID имеет 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc . PAGE_ID первого слайда в этой презентации — ge63a4b4_1_0 .
В примерах здесь используются маски полей , чтобы возвращать только конкретную запрошенную информацию о презентации, слайде и элементе страницы. Использование масок полей также повышает производительность.
Чтение идентификаторов объектов слайдов
В следующем примере presentations.get показано, как получить список всех идентификаторов объектов слайдов из презентации. Идентификаторы возвращаются в порядке представления слайдов и могут использоваться для указания конкретных слайдов в последующих запросах API. Вы можете получить идентификаторы объектов главных страниц и страниц макета таким же способом, используя fields=masters.objectId и fields=layout.objectId .
Ниже приведен протокол запроса на чтение идентификаторов объектов слайдов:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Ответ состоит из объекта Presentation , содержащего запрошенные идентификаторы объектов:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}Чтение идентификаторов объектов элементов со страницы
В следующем примере presentations.pages.get показано, как получить список идентификаторов объектов для всех элементов страницы на странице.
Ниже приведен протокол запроса для чтения идентификаторов объектов элементов со страницы:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
Ответ состоит из объекта Page , содержащего запрошенные идентификаторы объектов:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}Чтение элементов формы со страницы
В следующем примере presentations.pages.get показано, как получить список всех Shapes на странице. Вы можете получить другие типы PageElement , указав их с помощью параметра fields . Например, fields=pageElements(line,table) возвращает информацию только об элементах страницы line и table , если таковые присутствуют на странице.
Ниже приведен протокол запроса на чтение элементов формы со страницы:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
Ответ состоит из объекта Page , содержащего запрошенные элементы формы. Пустые фигурные скобки обозначают элементы страницы, которые не относятся к типу фигуры; в данном случае это элементы страницы изображения.
{
"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
}
}
}
]
}
}
},
...
]
}