Google Slides API를 사용하여 프레젠테이션, 페이지, 페이지 요소 데이터를 읽을 수 있습니다. 이 페이지의 예는 presentations.get
및 presentations.pages.get
메서드를 모두 사용하여 일반적인 읽기 작업을 실행하는 방법을 보여줍니다.
이 예시에서는 다음 자리표시자를 사용합니다.
- PRESENTATION_ID: 프레젠테이션 ID를 제공하는 위치를 나타냅니다. 이 ID의 값은 프레젠테이션 URL에서 찾을 수 있습니다.
- PAGE_ID: 페이지 객체 ID를 제공하는 위치를 나타냅니다. 이 값은 해당 URL에서 검색하거나 API 읽기 요청을 통해 검색할 수 있습니다.
이 예시는 언어 중립적인 HTTP 요청으로 제공됩니다. 이 예시는 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc
가 PRESENTATION_ID인 이 예시 프레젠테이션에서 읽습니다. 이 프레젠테이션의 첫 번째 슬라이드의 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 } } } ] } } }, ... ] }