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