Google Презентации (Google Slides)
Чтение, создание и правки Google Презентаций в процессах Pailot
Google Презентации (Google Slides) — облачные слайды. Блок читает, пишет, создаёт презентацию, заменяет текст, добавляет слайд и картинку через OAuth (вход по разрешению сервиса).
С Google Презентациями в Pailot вы можете:
- Читать слайды и создавать новую презентацию
- Писать на слайд по индексу и заменять все вхождения текста
- Добавлять слайд с макетом и картинку по публичному URL
- Получать превью слайда (ссылка действует 30 минут)
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Прочитать содержимое презентации.
| Параметр | Тип | Обязательный | Описание |
|---|
presentationId | string | Да | ID презентации |
| Параметр | Тип | Описание |
|---|
slides | json | Массив слайдов с содержимым |
metadata | json | Метаданные: ID, заголовок и URL |
Записать или обновить содержимое слайда.
| Параметр | Тип | Обязательный | Описание |
|---|
presentationId | string | Да | ID презентации |
content | string | Да | Текст для слайда |
slideIndex | number | Нет | Индекс слайда (по умолчанию первый) |
| Параметр | Тип | Описание |
|---|
updatedContent | boolean | Содержимое обновлено |
metadata | json | Обновлённые метаданные: ID, заголовок и URL |
Создать презентацию.
| Параметр | Тип | Обязательный | Описание |
|---|
title | string | Да | Заголовок презентации |
content | string | Нет | Текст первого слайда |
folderSelector | string | Нет | Папка, куда создать презентацию |
folderId | string | Нет | ID папки (служебное поле) |
| Параметр | Тип | Описание |
|---|
metadata | json | Метаданные созданной презентации: ID, заголовок и URL |
Найти и заменить все вхождения текста в презентации.
| Параметр | Тип | Обязательный | Описание |
|---|
presentationId | string | Да | ID презентации |
findText | string | Да | Что искать (например, \{\{placeholder\}\}) |
replaceText | string | Да | На что заменить |
matchCase | boolean | Нет | Учитывать регистр (по умолчанию true) |
pageObjectIds | string | Нет | ID слайдов через запятую — только на них. Пусто — все слайды |
| Параметр | Тип | Описание |
|---|
occurrencesChanged | number | Сколько вхождений заменили |
metadata | json | Метаданные: ID презентации и URL |
Добавить слайд с заданным макетом.
| Параметр | Тип | Обязательный | Описание |
|---|
presentationId | string | Да | ID презентации |
layout | string | Нет | Макет: BLANK, TITLE, TITLE_AND_BODY, TITLE_ONLY, SECTION_HEADER и др. По умолчанию BLANK |
insertionIndex | number | Нет | Индекс вставки с нуля. Если пусто — в конец |
placeholderIdMappings | string | Нет | JSON-массив соответствий плейсхолдеров. Формат: [\{"layoutPlaceholder":\{"type":"TITLE"\},"objectId":"custom_title_id"\}] |
| Параметр | Тип | Описание |
|---|
slideId | string | ID созданного слайда |
metadata | json | Метаданные: ID презентации, макет и URL |
Вставить картинку на слайд.
| Параметр | Тип | Обязательный | Описание |
|---|
presentationId | string | Да | ID презентации |
pageObjectId | string | Да | ID слайда |
imageUrl | string | Да | Публичный URL картинки (PNG, JPEG или GIF, максимум 50 МБ) |
width | number | Нет | Ширина в пунктах (по умолчанию 300) |
height | number | Нет | Высота в пунктах (по умолчанию 200) |
positionX | number | Нет | X от левого края в пунктах (по умолчанию 100) |
positionY | number | Нет | Y от верхнего края в пунктах (по умолчанию 100) |
| Параметр | Тип | Описание |
|---|
imageId | string | ID вставленной картинки |
metadata | json | Метаданные: ID презентации и URL картинки |
Превью слайда.
| Параметр | Тип | Обязательный | Описание |
|---|
presentationId | string | Да | ID презентации |
pageObjectId | string | Да | ID слайда |
thumbnailSize | string | Нет | Размер: SMALL (200px), MEDIUM (800px) или LARGE (1600px). По умолчанию MEDIUM |
mimeType | string | Нет | Тип картинки: PNG или GIF. По умолчанию PNG |
| Параметр | Тип | Описание |
|---|
contentUrl | string | URL превью (действует 30 минут) |
width | number | Ширина в пикселях |
height | number | Высота в пикселях |
metadata | json | Метаданные: ID презентации и ID слайда |