プレゼンテーションの操作

Slides API を使用すると、既存のプレゼンテーション ファイルの管理や新規作成ができます。 このページでは、Slides API を使用して一般的なプレゼンテーション操作を行うサンプルを紹介しています。

サンプルで使用する変数は次のとおりです。

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

以下の presentations.create リクエストでは、「My New Presentation」というタイトルが付いた空のプレゼンテーションを新規に作成しています。Drive API Files.create メソッドを使用し、mimeTypeapplication/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."
      }
    }
  ]
}

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。