API Google Презентаций позволяет читать данные презентаций, страниц и их элементов. Примеры на этой странице показывают, как выполнять распространённые операции чтения с использованием методов 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 } } } ] } } }, ... ] }