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