表示オペレーション

Google スライド API を使用すると、プレゼンテーション ファイルを作成したり、既存のファイルを管理したりできます。 このページの例では、一般的なページ プレゼンテーション操作を 使用して presentations.batchUpdate メソッドを示します。

これらの例は、言語に依存しない HTTP リクエストの形式で示されています。Google API クライアント ライブラリを使用してさまざまな言語でバッチ アップデートを実装する方法については、次のガイドをご覧ください。

プレゼンテーションを作成する

次の presentations.create コードサンプルは、「My New Presentation」というタイトルの空白のプレゼンテーション ファイルを作成する方法を示しています。

Google ドライブ API files.create メソッドを使用して、 MIME タイプとして application/vnd.google-apps.presentation を 指定することで、空白のプレゼンテーション ファイルを作成することもできます。

プレゼンテーションを作成するリクエスト プロトコルは次のとおりです。

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

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

スライド API には プレゼンテーションのリストを取得するメソッドはありませんが、 Drive API にはあります。以下の files.listメソッド は、フィールド マスク を使用して、ドライブからプレゼンテーション ファイルのリストを返します。このリストには、 ファイル ID、ファイル名、ファイルを開くためのリンクが含まれます。リクエストでは、 application/vnd.google-apps.presentationMIME タイプとして も指定します。

既存のプレゼンテーション ファイルを一覧表示するリクエスト プロトコルは次のとおりです。

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で指定されたプレゼンテーション全体でテキストを置換する方法を示しています。プレゼンテーション 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."
      }
    }
  ]
}