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 } } } ] } } }, ... ] }