API Google Slides позволяет создавать файлы презентаций и управлять существующими. В примерах на этой странице показаны некоторые распространенные операции представления страниц с использованием presentations.batchUpdate
.
Эти примеры представлены в виде HTTP-запросов, которые не зависят от языка. Чтобы узнать, как реализовать пакетное обновление на разных языках с помощью клиентских библиотек Google API, см. следующие руководства:
Создать презентацию
В следующем примере presentations.create
показано, как создать пустой файл презентации с названием «Моя новая презентация».
Также можно создавать пустые файлы презентаций с помощью метода files.create
API Google Диска, указав application/vnd.google-apps.presentation
в качестве типа MIME .
Ниже приведен протокол запроса на создание презентации:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
Список существующих файлов презентаций
API Slides не предоставляет метода получения списка презентаций, но API Drive предоставляет его. Метод files.list
(представленный ниже) использует маски полей для возврата списка файлов презентаций с вашего Диска с идентификатором файла, именем файла и ссылкой для открытия файла. В запросе также указывается application/vnd.google-apps.presentation
в качестве типа MIME .
Ниже приведен протокол запроса на получение списка существующих файлов презентации:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
Ответ на этот запрос имеет следующую структуру:
{ "files": [ { "id": "abcdefghijklmnopqrstuvwxyz0123456789", "name": "Project Vision", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk" }, { "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "name": "Untitled Presentation", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk" }, ... ] }
Замена текста во всей презентации
В следующем примере presentations.batchUpdate
показано, как использовать метод ReplaceAllTextRequest
для замены текста во всей презентации, заданной PRESENTATION_ID . Вы можете узнать значение идентификатора презентации по URL-адресу презентации.
Каждый экземпляр строки «Gizmo Corp.» заменяется текстом «Gadget Inc.». Сюда входит текст в текстовых полях и других фигурах, на слайдах и в мастерах. В этом случае замена текста чувствительна к регистру, если для matchCase
установлено true
.
Ниже приведен протокол запроса на замену текста во всей презентации:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }