API Google Slides позволяет добавлять и изменять элементы на страницах презентации. В примерах на этой странице показано, как выполнять распространенные операции чтения с помощью presentations.batchUpdate
.
В этих примерах используются следующие переменные:
- PRESENTATION_ID —Указывает, где вы предоставляете идентификатор презентации . Вы можете узнать значение этого идентификатора по URL-адресу презентации.
- PAGE_ID —Указывает, где вы предоставляете идентификатор объекта страницы . Вы можете получить это значение по URL-адресу или с помощью запроса на чтение API.
- PAGE_ELEMENT_ID —Указывает, где вы предоставляете идентификатор объекта элемента страницы . Вы можете указать этот идентификатор для создаваемых вами элементов (с некоторыми ограничениями ) или разрешить Slides API автоматически создавать его. Идентификаторы элементов можно получить с помощью запроса на чтение API.
Эти примеры представлены в виде HTTP-запросов, которые не зависят от языка. Чтобы узнать, как реализовать пакетное обновление на разных языках с помощью клиентских библиотек Google API, см. раздел Добавление фигур и текста .
Добавление текстового поля на слайд
В следующем примере presentations.batchUpdate
показано, как использовать метод CreateShapeRequest
для добавления нового текстового поля (содержащего строку «Мое добавленное текстовое поле») на слайд, указанный PAGE_ID . В теле запроса указываются два запроса: один для создания формы текстового поля (с заданным размером и расположением), а второй для вставки в него текста.
Первый запрос указывает идентификатор объекта, который будет использоваться для текстового поля. Это позволяет второму запросу использовать его в том же вызове API, сокращая накладные расходы.
Ниже приведен протокол запроса на добавление текстового поля на слайд:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createShape": { "objectId": PAGE_ELEMENT_ID, "shapeType": "TEXT_BOX", "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 150, "unit": "PT" }, "height": { "magnitude": 50, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 200, "translateY": 100, "unit": "PT" } } } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "My Added Text Box", "insertionIndex": 0 } } ] }
Добавить изображение на слайд
В следующем примере presentations.batchUpdate
показано, как использовать метод CreateImageRequest
для добавления изображения на слайд, указанный PAGE_ID . API получает изображение, используя IMAGE_URL . Этот запрос также масштабирует и позиционирует изображение на слайде.
Ниже приведен протокол запроса на добавление изображения на слайд:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createImage": { "url": IMAGE_URL, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 30, "unit": "PT" }, "height": { "magnitude": 30, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 200, "translateY": 100, "unit": "PT" } } } } ] }
Удаление страницы или элемента страницы
В следующем примере presentations.batchUpdate
показано, как использовать метод DeleteObjectRequest
для удаления элемента страницы, указанного PAGE_ELEMENT_ID , и слайда, указанного PAGE_ID с помощью двух отдельных запросов.
Ниже приведен протокол запроса на удаление страницы или элемента страницы:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteObject": { "objectId": PAGE_ELEMENT_ID }, "deleteObject": { "objectId": PAGE_ID } } ] }
Редактировать текст в указанной форме
В следующем примере presentations.batchUpdate
показано, как использовать метод DeleteTextRequest
для замены части текста, присутствующего в форме, указанной PAGE_ELEMENT_ID . Для этого сначала удалите текст, используя startIndex
начинающийся с нуля, а затем вставьте новый текст в эту позицию. В этом примере исходная текстовая строка «Текст моей фигуры: ????» заменяется на «Текст моей фигуры: трапеция».
Этот запрос влияет только на текст указанной формы. Чтобы заменить текст повсюду в презентации, используйте метод ReplaceAllTextRequest
.
Ниже приведен протокол запроса на редактирование текста в указанной форме:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": PAGE_ELEMENT_ID, "textRange": { "type": "FROM_START_INDEX", "startIndex": 15 } } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "Trapezoid", "insertionIndex": 15 } } ] }
Замена тега формы изображением
Теги — это текстовые поля или фигуры с уникальным строковым именем, например «имя владельца учетной записи».
В следующем примере presentations.batchUpdate
показано, как использовать метод CreateImageRequest
для замены одного экземпляра тега формы изображением, сохраняя то же положение и масштабируя его в соответствии с размером тега, сохраняя при этом соотношение сторон изображения.
Запрос также можно использовать для замены одного изображения другим. Запрос состоит из добавления нового изображения и последующего удаления тега.
Метод CreateImageRequest
заменяет только указанную фигуру. Чтобы заменить фигуры тегов повсюду в презентации, используйте метод ReplaceAllShapesWithImageRequest
.
Тег формы имеет следующие свойства PageElement
(которые можно найти с помощью presentations.pages.get
):
{ "objectId": PAGE_ELEMENT_ID, "size": { "width": { "magnitude": 3000000, "unit": "EMU" }, "height": { "magnitude": 3000000, "unit": "EMU" } }, "transform": { "scaleX": 1.13, "scaleY": 0.62, "translateX": 4800000, "translateY": 450000, "unit": "EMU" }, "shape": { "shapeType": "RECTANGLE" } }
Фигура находится на слайде, указанном PAGE_ID . Чтобы указать изображение, которое заменяет фигуру, API получает изображение, используя IMAGE_URL . Чтобы сохранить соотношение сторон изображения, ограничивая его размером тега, метод CreateImageRequest
устанавливает как размер изображения в произведение размера тега и масштаба, так и коэффициенты масштабирования изображения равные 1
. Дополнительную информацию см. в разделе Сохранение соотношения сторон .
Ниже приведен протокол запроса на замену тега формы изображением:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createImage": { "url": IMAGE_URL, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 3000000 * 1.13, "unit": "EMU" }, "height": { "magnitude": 3000000 * 0.62, "unit": "EMU" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 4800000, "translateY": 450000, "unit": "PT" } } } }, { "deleteObject": { "objectId": PAGE_ELEMENT_ID } } ] }