Операции представления

API Google Slides позволяет создавать файлы презентаций и управлять существующими. Примеры на этой странице демонстрируют некоторые распространенные операции с презентациями с использованием метода presentations.batchUpdate .

Эти примеры представлены в виде HTTP-запросов, чтобы обеспечить языковую нейтральность. Чтобы узнать, как реализовать пакетное обновление на разных языках с использованием клиентских библиотек Google API, см. следующие руководства:

Создать презентацию

Приведенный ниже пример кода presentations.create показывает, как создать пустой файл презентации с названием «Моя новая презентация».

Также можно создавать пустые файлы презентаций, используя метод files.create API Google Drive, указав в качестве MIME-типа application/vnd.google-apps.presentation .

Ниже представлен протокол запроса для создания презентации:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

Список существующих файлов презентаций

API Slides не предоставляет метода для получения списка презентаций, в отличие от API Google Drive . Метод files.list (описан ниже) использует маски полей для возврата списка файлов презентаций с вашего Google Drive, содержащих идентификатор файла, имя файла и ссылку для открытия файла. В запросе также указывается MIME-тип application/vnd.google-apps.presentation .

Ниже приведён протокол запроса для получения списка существующих файлов презентаций:

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