Google Sheets API を使用すると、プレゼンテーション ファイルを作成したり、既存のファイルを管理したりできます。このページの例では、presentations.batchUpdate
メソッドを使用した一般的なページ表示操作を示しています。
これらの例では、言語に依存しない HTTP リクエストとして記載しています。Google API クライアント ライブラリを使用してさまざまな言語でバッチ アップデートを実装する方法については、次のガイドをご覧ください。
プレゼンテーションを作成する
次の presentations.create
コードサンプルは、「My New Presentation」という名前の空のプレゼンテーション ファイルを作成する方法を示しています。
Google Drive API の files.create
メソッドを使用して、application/vnd.google-apps.presentation
を MIME タイプとして指定し、空のプレゼンテーション ファイルを作成することもできます。
プレゼンテーションを作成するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
既存のプレゼンテーション ファイルを一覧表示する
プレゼンテーションのリストを取得するためのメソッドは、Slides API にはありませんが、Drive API には用意されています。
files.list
メソッド(下記参照)は、フィールド マスクを使用して、ドライブ内のプレゼンテーション ファイルのリスト(ファイル ID、ファイル名、ファイルを開くためのリンクを含む)を返します。また、このリクエストでは 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 で指定されたプレゼンテーション全体のテキストを置換する方法を示しています。プレゼンテーション ID の値はプレゼンテーション URL から確認できます。
「Gizmo Corp.」という文字列はすべて「DEVICE Inc.」というテキストに置き換えられます。これには、テキスト ボックスやその他のシェイプ、スライド、マスター内のテキストが含まれます。この場合、matchCase
を true
に設定することで、テキストの置換で大文字と小文字が区別されます。
プレゼンテーション全体のテキストを置換するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }