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

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