Google Sheets API を使用すると、プレゼンテーション、ページ、ページ要素のデータを読み取ることができます。「
このページの例では、
presentations.get
、
presentations.pages.get
あります。
これらの例では、次のプレースホルダを使用しています。
- PRESENTATION_ID - リソースに プレゼンテーション ID。Google Chat では プレゼンテーションの URL からこの ID の値を検出します。
- PAGE_ID - ページ オブジェクトを指定する場所を示します。 ID。必要に応じて この値を取得するには、URL から、または API 読み取りリクエストを使用します。
これらの例では、言語に依存しない HTTP リクエストとして記載しています。「
このサンプルから抜粋した例
プレゼンテーション、
(1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc
を含む)
PRESENTATION_ID。PAGE_ID の
最初
スライド
このプレゼンテーションでは ge63a4b4_1_0
です。
ここで説明するフィールド マスクは、 プレゼンテーション、スライド、ページに関する特定の要求された情報を返す 要素です。フィールド マスクを使用するとパフォーマンスも向上します。
スライド オブジェクト ID の読み取り
次の
presentations.get
コード
サンプルは、すべてのスライド オブジェクト ID のリストを
説明します。ID はスライドの表示順に返されます。
後続の API リクエストで特定のスライドを示すために使用されます。こちらの
マスターページとレイアウトページのオブジェクト ID を、
fields=masters.objectId
と fields=layout.objectId
。
スライド オブジェクト ID を読み取るリクエスト プロトコルは次のとおりです。
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
レスポンスは
Presentation
オブジェクトを返します。
{ "slides": [ { "objectId": "ge63a4b4_1_0" }, { "objectId": "ge63a4b4_1_9" }, { "objectId": "ge63a4b4_1_23" }, { "objectId": "ge63a4b4_1_35" }, { "objectId": "ge63a4b4_1_43" } ] }
ページから要素のオブジェクト ID を読み取る
次の
presentations.pages.get
すべてのページ要素のオブジェクト ID のリストを取得するコードサンプル
特定します
ページから要素のオブジェクト ID を読み取るリクエスト プロトコルは次のとおりです。
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
レスポンスは
Page
オブジェクト
次の要素が含まれます。
{ "pageElements": [ { "objectId": "ge63a4b4_1_5" }, { "objectId": "ge63a4b4_1_6" }, { "objectId": "ge63a4b4_1_7" }, { "objectId": "ge63a4b4_1_8" } ] }
ページからシェイプ要素を読み取る
次の
presentations.pages.get
このコードサンプルは、すべてのリソースのリストと
Shapes
特定します他のエンティティを
PageElement
fields
パラメータで種類を指定できます。たとえば
fields=pageElements(line,table)
は、次の情報のみを返します。
line
および
table
ページ要素(存在する場合)を返します。
ページからシェイプ要素を読み取るリクエスト プロトコルは次のとおりです。
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
レスポンスは
Page
オブジェクト
リクエストしたシェイプ要素が含まれています。空の中かっこはページ要素を示します
未加工のもののみを表示できます。この例では画像ページ要素です
{ "pageElements": [ {}, {}, { "shape": { "shapeProperties" { "outline" { "dashStyle": "SOLID", "outlineFill": { "solidFill": { "alpha": 1, "color": { "rgbColor": {} } }, }, "propertyState": "NOT_RENDERED", "weight": { "magnitude": 9525, "unit": "EMU" } }, "shadow": { "alignment": "BOTTOM_LEFT", "alpha": 1, "blurRadius": { "unit": "EMU" }, "color": { "rgbColor": {} }, "propertyState": "NOT_RENDERED", "rotateWithShape": false, "transform": { "scaleX": 1, "scaleY": 1, "unit": "EMU" }, "type": "OUTER" }, "shapeBackgroundFill" : { "propertyState": "NOT_RENDERED", "solidFill": { "alpha": 1, "color": { "rgbColor: { "blue": 1, "green": 1, "red": 1 } } } } }, "shapeType": "TEXT_BOX", "text": { "textElements": [ { "endIndex": 11, "paragraphMarker": { "style": { "alignment": "START", "direction": "LEFT_TO_RIGHT", "indentEnd": { "unit": "PT" }, "indentFirstLine": { "unit": "PT" }, "indentStart": { "unit": "PT" }, "lineSpacing": 100, "spaceAbove": { "unit": "PT" }, "spaceBelow": { "unit": "PT" }, "spacingMode": "COLLAPSE_LISTS" } } }, { "endIndex": 11, "textRun": { "content": "Baby Album\n", "style": { "backgroundColor": {}, "baselineOffset": "NONE", "bold": false, "fontFamily": "Arial", "fontSize": { "magnitude": 14, "unit": "PT" }, "foregroundColor": { "opaqueColor": { "rgbColor": {} } }, "italic": false, "smallCaps": false, "strikethrough": false, "underline": false } } } ] } } }, ... ] }