プレゼンテーション オペレーション

Slides API を使用して、既存のプレゼンテーション ファイルを管理し、新しいプレゼンテーション ファイルを作成できます。このページの例は、API を使用して実行できる一般的なプレゼンテーション オペレーションを示しています。

この例では、次の変数を使用します。

  • presentationId - プレゼンテーション ID を提供する場所を示します。この ID の値は、プレゼンテーションの URL で確認できます。
  • pageId - ページ オブジェクト ID を指定する場所を示します。この値は、URL から、または API 読み取りリクエストを使用して取得できます。
  • pageElementId - ページ要素オブジェクト ID を指定する場所を示します。この ID は、作成する要素に（なんらかの制限で）指定することも、API で自動的に作成されるようにすることもできます。要素 ID は、API 読み取りリクエストを通じて取得できます。

新しいプレゼンテーションを作成

次の presentations.create リクエストでは、「My New presentation」というタイトルの空のファイルを新たに作成します。Google Drive API Files.create メソッドを使用して空のプレゼンテーション ファイルを作成することもできます。mimeType として application/vnd.google-apps.presentation を指定します。

リクエスト プロトコルを以下に示します。プレゼンテーションの作成と管理のガイドには、Google API クライアント ライブラリを使用してバッチ アップデートを異なる言語で実装している例が記載されています。

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

既存のプレゼンテーション ファイルを一覧表示する

Slides API にはプレゼンテーションのリストを取得するメソッドはありませんが、Drive API を使用すればこれらを簡単に取得できます。ここに示している Drive API Files.list リクエストでは、フィールド マスクを使用して、ドライブにあるプレゼンテーション ファイルのリストとファイル ID、タイトル、リンクが返されます。

リクエスト プロトコルを以下に示します。Drive API のファイル検索ガイドには、Google API クライアント ライブラリを使用してさまざまな言語でファイル検索リクエストを実装する例が記載されています。

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 リクエストは、presentationId で指定されたプレゼンテーション全体のテキストを置き換えます。文字列「Gizmo Corp.」はすべて「Gadget Inc.」というテキストに置き換えられます。これには、テキスト ボックスやその他のシェイプ、スライド、マスター上のテキストが含まれます。この場合、テキスト置換では大文字と小文字が区別されます。

リクエスト プロトコルを以下に示します。データのスライドへの統合ガイドでは、Google API クライアント ライブラリを使用してバッチ アップデートを異なる言語で実装している例を示しています。

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}