Google スライド API を使用すると、プレゼンテーション、ページ、ページ要素のデータを読み取ることができます。このページの例では、
presentations.get と
presentations.pages.get
の両方を使用して、一般的な読み取りオペレーションを実行する方法を示します。
これらの例では、次のプレースホルダを使用します。
- PRESENTATION_ID： プレゼンテーション ID を指定する場所を示します。この ID の値は、プレゼンテーションの URL から確認できます。
- PAGE_ID：ページ オブジェクト IDを指定する場所を示します。この値は、URL から取得するか、API 読み取りリクエストを使用して取得できます。
これらの例は、言語に依存しない HTTP リクエストとして示されています。この例では、サンプル プレゼンテーションから読み取ります。
その
PRESENTATION_IDは 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc です。このプレゼンテーションの
最初
のスライドの PAGE_ID は ge63a4b4_1_0 です。
ここの例では、フィールド マスクを使用して、プレゼンテーション、スライド、ページ 要素 に関する特定の要求された情報のみを返します。フィールド マスクを使用すると、パフォーマンスも向上します。
スライド オブジェクト ID を読み取る
次の
presentations.getコード
サンプルは、プレゼンテーションからすべてのスライド オブジェクト ID のリストを取得する方法を示しています。ID はスライドのプレゼンテーション順に返され、後続の API リクエストで特定のスライドを示すために使用できます。fields=masters.objectId と fields=layout.objectId を使用すると、マスターページとレイアウト ページのオブジェクト ID を同じ方法で取得できます。
スライド オブジェクト 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
レスポンスは、リクエストされたオブジェクト ID を含む
Page オブジェクト
で構成されます。
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}ページから図形要素を読み取る
次の
presentations.pages.get
コードサンプルは、ページ上のすべての
Shapes
のリストを取得する方法を示しています。fields パラメータを使用して指定することで、他の
PageElement
種類を取得できます。たとえば、
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 } } } ] } } }, ... ] }