Google Slides API를 사용하면 프레젠테이션, 페이지, 페이지 요소 데이터를 읽을 수 있습니다. 이 페이지의 예에서는 presentations.get 및 presentations.pages.get 메서드를 모두 사용하여 일반적인 읽기 작업을 실행하는 방법을 보여줍니다.
이 예시에서는 다음 자리표시자를 사용합니다.
- PRESENTATION_ID: 프레젠테이션 ID를 제공하는 위치를 나타냅니다. 프레젠테이션 URL에서 이 ID의 값을 확인할 수 있습니다.
- 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 } } } ] } } }, ... ] }