Google Slides API를 사용하면 프레젠테이션 페이지에 요소를 추가하고 수정할 수 있습니다. 이
이 페이지의 예시는
presentations.batchUpdate
메서드를 사용하여 축소하도록 요청합니다.
이 예에서는 다음 변수를 사용합니다.
- PRESENTATION_ID: 프레젠테이션 ID를 입력합니다. 다음과 같은 작업을 할 수 있습니다. 이 ID에 대한 값을 검색합니다.
- PAGE_ID: 페이지 객체를 제공하는 위치를 나타냅니다. ID를 입력합니다. 다음을 가져올 수 있습니다. 이 값에 대한 값을 URL에서 가져오거나 API 읽기 요청을 사용하여 가져올 수 있습니다.
- PAGE_ELEMENT_ID: 페이지를 제공하는 위치를 나타냅니다. 요소 객체 ID를 포함해야 합니다. 나 만든 요소에 대해 이 ID를 지정할 수 있습니다 (일부 제한사항) Slides API에서 자동으로 만들도록 허용할 수 있습니다. 요소 ID API 읽기 요청을 통해 가져올 수 있습니다.
이 예는 언어 중립을 위해 HTTP 요청으로 제공됩니다. 배우기 위해 Google API를 사용하여 다양한 언어로 일괄 업데이트를 구현하는 방법 자세한 내용은 도형 추가 및 텍스트를 입력합니다.
슬라이드에 텍스트 상자 추가하기
다음
presentations.batchUpdate
코드 샘플을 사용하여
CreateShapeRequest
메서드를 사용하여 새 텍스트 상자('내가 추가한 텍스트 상자'라는 문자열 포함)를
PAGE_ID에서 지정한 슬라이드입니다. 두 개의 요청은
요청 본문 - 텍스트 상자 도형 (주어진 크기와
위치)를 입력하고 두 번째 버튼을 클릭하여 여기에 텍스트를 삽입합니다.
첫 번째 요청은 객체에서 사용할 ID 입력합니다. 이렇게 하면 두 번째 요청이 동일한 API 호출에서 이를 사용할 수 있으므로 발생할 수 있습니다
다음은 슬라이드에 텍스트 상자를 추가하는 요청 프로토콜입니다.
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createShape": { "objectId": PAGE_ELEMENT_ID, "shapeType": "TEXT_BOX", "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 150, "unit": "PT" }, "height": { "magnitude": 50, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 200, "translateY": 100, "unit": "PT" } } } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "My Added Text Box", "insertionIndex": 0 } } ] }
슬라이드에 이미지 추가
다음
presentations.batchUpdate
코드 샘플을 사용하여
CreateImageRequest
메서드를 사용하여 PAGE_ID에서 지정한 슬라이드에 이미지를 추가합니다. 이
API가 IMAGE_URL를 사용하여 이미지를 가져옵니다. 이 요청은 또한
슬라이드에서 이미지의 크기를 조정하고 위치를 지정합니다.
다음은 슬라이드에 이미지를 추가하는 요청 프로토콜입니다.
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createImage": { "url": IMAGE_URL, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 30, "unit": "PT" }, "height": { "magnitude": 30, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 200, "translateY": 100, "unit": "PT" } } } } ] }
페이지 또는 페이지 요소 삭제
다음
presentations.batchUpdate
코드 샘플을 사용하여
DeleteObjectRequest
PAGE_ELEMENT_ID로 지정된 페이지 요소를 삭제하는 메서드
두 개의 개별 요청을 사용하여 PAGE_ID로 지정된 슬라이드입니다.
다음은 페이지 또는 페이지 요소를 삭제하는 요청 프로토콜입니다.
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteObject": { "objectId": PAGE_ELEMENT_ID }, "deleteObject": { "objectId": PAGE_ID } } ] }
지정된 도형에서 텍스트 수정
다음
presentations.batchUpdate
코드 샘플을 사용하여
DeleteTextRequest
메서드를 사용하여 지정된 도형에 나타나는 텍스트의 일부를
PAGE_ELEMENT_ID 이렇게 하려면 먼저
0부터 시작하는 startIndex
를 사용하고 그 위치에 새 텍스트를 삽입합니다. 이
예를 들어 원본 텍스트 문자열 'My Shape Text: ????'는 '내
도형 텍스트: 사다리꼴'.
이 요청은 지정된 도형의 텍스트에만 영향을 미칩니다. 모든 곳에서 텍스트 바꾸기
를 사용하려면
ReplaceAllTextRequest
메서드를 사용하여 축소하도록 요청합니다.
다음은 지정된 도형에서 텍스트를 수정하는 요청 프로토콜입니다.
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": PAGE_ELEMENT_ID, "textRange": { "type": "FROM_START_INDEX", "startIndex": 15 } } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "Trapezoid", "insertionIndex": 15 } } ] }
도형 태그를 이미지로 바꾸기
태그는 고유 문자열 이름이 있는 텍스트 상자나 도형입니다(예: 'account-owner-name'입니다.
다음
presentations.batchUpdate
코드 샘플을 사용하여
CreateImageRequest
메서드를 사용하여 도형 태그의 단일 인스턴스를 이미지로 대체할 수 있습니다.
이미지의 크기를 유지하면서 태그 크기에 맞게
크기를 조절합니다.
가로세로 비율
이 요청을 사용하여 한 이미지를 다른 이미지로 바꿀 수도 있습니다. 요청 새 이미지를 추가한 다음 태그를 삭제하는 단계로 구성됩니다.
CreateImageRequest
메서드는 지정된 도형만 바꿉니다. 태그 교체 방법
사용하려면
ReplaceAllShapesWithImageRequest
메서드를 사용하여 축소하도록 요청합니다.
도형 태그에는 다음이 있습니다.
PageElement
속성(
presentations.pages.get
요청):
{ "objectId": PAGE_ELEMENT_ID, "size": { "width": { "magnitude": 3000000, "unit": "EMU" }, "height": { "magnitude": 3000000, "unit": "EMU" } }, "transform": { "scaleX": 1.13, "scaleY": 0.62, "translateX": 4800000, "translateY": 450000, "unit": "EMU" }, "shape": { "shapeType": "RECTANGLE" } }
도형은 PAGE_ID로 지정된 슬라이드에 있습니다. 지정
셰이프를 대체하는 이미지인 경우, API는
IMAGE_URL 이미지의 가로 세로 비율을 제한하면서 비율을 유지하기 위해
태그 크기에 관계 없이
CreateImageRequest
메서드는 이미지 크기를 태그 크기와 배율의 곱으로 설정하고
이미지 배율을 1
로 설정합니다. 자세한 내용은 측면 보존을 참조하세요.
비율을 사용합니다.
다음은 도형 태그를 이미지로 대체하는 요청 프로토콜입니다.
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createImage": { "url": IMAGE_URL, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 3000000 * 1.13, "unit": "EMU" }, "height": { "magnitude": 3000000 * 0.62, "unit": "EMU" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 4800000, "translateY": 450000, "unit": "PT" } } } }, { "deleteObject": { "objectId": PAGE_ELEMENT_ID } } ] }