기본 읽기

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

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

  • PRESENTATION_ID: 프레젠테이션 ID를 입력하는 위치를 나타냅니다. 프레젠테이션 URL에서 이 ID 값을 확인할 수 있습니다.
  • PAGE_ID: 페이지 객체 ID를 제공하는 위치를 나타냅니다. 이 값은 URL에서 가져오거나 API 읽기 요청을 사용하여 검색할 수 있습니다.

이 예는 언어 중립적인 HTTP 요청으로 표시됩니다. 이 예는 이 프레젠테이션 예에서 확인할 수 있으며, PRESENTATION_ID1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc입니다. 이 프레젠테이션에 있는 첫 번째 슬라이드PAGE_IDge63a4b4_1_0입니다.

여기에 나온 예에서는 필드 마스크를 사용하여 프레젠테이션, 슬라이드, 페이지 요소에 관해 요청된 특정 정보만 반환합니다. 필드 마스크를 사용하면 성능도 향상됩니다.

슬라이드 객체 ID 읽기

다음 presentations.get 코드 샘플은 프레젠테이션에서 모든 슬라이드 객체 ID 목록을 가져오는 방법을 보여줍니다. ID는 슬라이드 프레젠테이션 순서로 반환되며 후속 API 요청에서 특정 슬라이드를 나타내는 데 사용할 수 있습니다. fields=masters.objectIdfields=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)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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}