基本的な読み取り

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

これらの例では、次のプレースホルダを使用します。

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

これらの例は、言語に依存しない HTTP リクエストとして表示されます。この例では、PRESENTATION_ID1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc であるこのサンプル プレゼンテーションから読み取ります。このプレゼンテーションの最初のスライドPAGE_IDge63a4b4_1_0 です。

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

スライド オブジェクト ID を読み取る

次の presentations.get コードサンプルは、プレゼンテーションからすべてのスライド オブジェクト ID のリストを取得する方法を示しています。この ID はスライドのプレゼンテーション順に返され、後続の API リクエストで特定のスライドを示すために使用できます。マスターページとレイアウト ページのオブジェクト ID は、fields=masters.objectIdfields=layout.objectId を使用して同じ方法で取得できます。

スライド オブジェクト ID を読み取るリクエスト プロトコルは次のとおりです。

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId

レスポンスは、リクエストされたオブジェクト ID を含む 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 のリストを取得する方法を示しています。他の PageElement の種類を取得するには、fields パラメータを使用して指定します。たとえば fields=pageElements(line,table) は、linetable のページ要素に関する情報(ページに存在する場合)のみを返します。

以下は、ページからシェイプ要素を読み取るリクエスト プロトコルです。

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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}