기본 읽기

Google Slides API를 사용하면 프레젠테이션, 페이지, 페이지 요소 데이터를 읽을 수 있습니다. 이 페이지의 예에서는 presentations.get 및 presentations.pages.get 메서드를 모두 사용하여 일반적인 읽기 작업을 실행하는 방법을 보여줍니다.

이 예에서는 다음 자리표시자를 사용합니다.

  • PRESENTATION_ID—프레젠테이션 ID를 제공하는 위치를 나타냅니다. 프레젠테이션 URL에서 이 ID의 값을 찾을 수 있습니다.
  • 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

응답은 요청된 객체 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 의 목록을 검색하는 방법을 보여줍니다. 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}