- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- 요청
- CreateSlideRequest
- LayoutReference
- 사전 정의된 레이아웃
- LayoutPlaceholderIdMapping
- CreateShapeRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnsRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- ReplaceAllTextRequest
- SubstringMatchCriteria
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode
- UpdateSlidesPositionRequest
- DeleteTextRequest
- 범위
- 유형
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- LinkingMode
- CreateLineRequest
- 카테고리
- RefreshSheetsChartRequest
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletRequest
- 글머리기호
- ReplaceAllShapesWithImageRequest
- ReplaceMethod를 사용합니다.
- ImageReplace메서드
- DuplicateObjectRequest
- UpdateTextStyleRequest
- ReplaceAllShapesWithSheetsChartRequest
- LinkingMode
- DeleteParagraphBulletRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- 경계선 위치
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- ReplaceImageRequest
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- 응답
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- ReplaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- ReplaceAllShapesWithImageResponse
- DuplicateObjectResponse
- ReplaceAllShapesWithSheetsChartResponse
- GroupObjectsResponse
- 실습
프레젠테이션에 하나 이상의 업데이트를 적용합니다.
각 request
는 적용되기 전에 확인됩니다. 유효하지 않은 요청이 있으면 전체 요청이 실패하고 아무것도 적용되지 않습니다.
일부 요청에는 적용되는 방식에 관한 정보를 제공하는 replies
가 있습니다. 다른 요청은 정보를 반환할 필요가 없습니다. 이러한 요청은 모두 빈 응답을 반환합니다. 답장 순서는 요청의 순서와 일치합니다.
예를 들어, 업데이트 4개가 포함된 batchUpdate를 호출하고 세 번째 업데이트만 정보를 반환한다고 가정해 보겠습니다. 응답에 세 가지 요청에 대한 빈 응답 두 개가 순서대로 포함됩니다.
다른 사용자가 프레젠테이션을 수정하고 있을 수 있기 때문에 프레젠테이션이 내 변경사항을 정확히 반영하지 못할 수도 있습니다. 변경사항은 공동작업자의 변경사항에 따라 변경될 수 있습니다. 공동작업자가 없으면 프레젠테이션에 변경사항이 반영되어야 합니다. 어떤 경우든 요청의 업데이트는 원자적으로 함께 적용됩니다.
HTTP 요청
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
presentationId |
업데이트를 적용할 프레젠테이션입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "requests": [ { object ( |
필드 | |
---|---|
requests[] |
프레젠테이션에 적용할 업데이트 목록입니다. |
writeControl |
쓰기 요청이 실행되는 방식을 제어합니다. |
응답 본문
일괄 업데이트의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "presentationId": string, "replies": [ { object ( |
필드 | |
---|---|
presentationId |
업데이트가 적용된 프레젠테이션입니다. |
replies[] |
업데이트의 답장입니다. 업데이트와 1:1로 매핑되지만 일부 요청에 대한 응답은 비어 있을 수 있습니다. |
writeControl |
요청을 적용한 후 업데이트된 쓰기 제어 |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/presentations
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
자세한 내용은 승인 가이드를 참고하세요.
쓰기 제어
쓰기 요청이 실행되는 방식을 제어합니다.
JSON 표현 |
---|
{ "requiredRevisionId": string } |
필드 | |
---|---|
requiredRevisionId |
쓰기 요청에 필요한 프레젠테이션의 필수 버전 ID가 응답에서 반환되면 요청이 적용된 후 문서의 버전 ID를 나타냅니다. |