基本的な読み取り

Slides API を使用すると、プレゼンテーション、ページ、ページ要素のデータを読み取ることができます。 このページでは、presentations.get メソッドと presentations.pages.get メソッドを使用して一般的な読み取り処理を行う方法をサンプルを用いて説明します。

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

  • presentationId: プレゼンテーション ID を指定する場所を示します。 この ID の値はプレゼンテーションの URL で確認できます。
  • pageId: ページのオブジェクト ID を指定する場所を示します。 この ID の値は URL から、または API の読み取りリクエストを使用して取得できます。

このページの例では、こちらのサンプル プレゼンテーションからデータを読み取ります。このプレゼンテーションの presentationId1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc です。 また、このプレゼンテーションの 1 枚目のスライドpageIdge63a4b4_1_0 になります。

この例は、フィールド マスクを使用して、プレゼンテーション、スライド、ページ要素に関する要求された特定の情報のみを返します。 このようにフィールド マスクを使用することでパフォーマンスが向上します。

スライド オブジェクト ID の読み取り

以下の presentations.get リクエストでは、プレゼンテーションから、すべてのスライド オブジェクト ID を含むリストを取得しています。 ID はスライド プレゼンテーションの順で返され、後に API リクエストで特定のスライドを指定する際にその ID を使用することができます。 マスターおよびレイアウト ページのオブジェクト ID は、それぞれ fields=masters.objectId および fields=layout.objectId を使用すると同様の方法で取得できます。

GET https://slides.googleapis.com/v1/presentations/presentationId?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 のリストを取得しています。

GET https://slides.googleapis.com/v1/presentations/presentationId/pages/pageId?fields=pageElements.objectId

このメソッド呼び出しのレスポンスとして返される Page オブジェクトには、リクエストされたコンポーネントが含まれます。

{
  "pageElements": [
    {
      "objectId": "ge63a4b4_1_5"
    },
    {
      "objectId": "ge63a4b4_1_6"
    },
    {
      "objectId": "ge63a4b4_1_7"
    },
    {
      "objectId": "ge63a4b4_1_8"
    }
  ]
}

ページからシェイプ要素を読み取る

以下の presentations.pages.get リクエストでは、ページ上のすべてのシェイプ要素を含むリストを取得しています。 他の種類のページ要素を取得するには、それらを fields パラメータで指定します。 たとえば fields=pageElements(line,table) とすると、ページ上に linetable が存在すれば、それらのページ要素の情報のみが返されます。

この例のリクエスト プロトコルは次のとおりです。

GET https://slides.googleapis.com/v1/presentations/presentationId/pages/pageId?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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}

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

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