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

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

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

• Создание и управление презентациями
• Поиск файлов и папок
• Объединить данные в презентацию

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

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

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

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

POST https://slides.googleapis.com/v1/presentations

{
  "title": "My New Presentation"
}

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

API Slides не предоставляет метод для получения списка презентаций, но API Drive предоставляет его. Метод files.list (представленный ниже) использует маски полей для возврата списка файлов презентаций с вашего Диска, включая идентификатор файла, его имя и ссылку для открытия. В запросе также указан 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."
      }
    }
  ]
}