- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- 要求
- CreateSlideRequest
- LayoutReference
- 預先定義的版面配置
- LayoutPlaceholderIdMapping
- CreateShapeRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableCOLUMNRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- ReplaceAllTextRequest
- SubstringMatchCriteria
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- 套用模式
- UpdateSlidesPositionRequest
- DeleteTextRequest
- 範圍
- 類型
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- LinkingMode
- CreateLineRequest
- 類別
- RefreshSheetsChartRequest
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletRequest
- BulletGlyphPreset
- ReplaceAllShapesWithImageRequest
- 取代方法
- ImageReplaceMethod
- DuplicateObjectRequest
- UpdateTextStyleRequest
- ReplaceAllShapesWithSheetsChartRequest
- LinkingMode
- DeleteParagraphBulletRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- 邊框位置
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnMergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- 替換圖片要求
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- 回應
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- ReplaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- ReplaceAllShapesWithImageResponse
- DuplicateObjectResponse
- ReplaceAllShapesWithSheetsChartResponse
- GroupObjectsResponse
- 試試看!
為簡報套用一或多則更新。
每個 request
必須先經過驗證才能套用。如果有任何要求無效,整個請求就會失敗,系統不會套用任何要求。
某些要求會透過 replies
提供一些資訊,讓您瞭解應如何套用。有些要求不需要傳回資訊,而每個要求都會傳回空白的回覆。回覆的順序會與要求相符。
舉例來說,假設您在呼叫 updateUpdate 時加上四則更新,只有第三次傳回資訊。回應會有兩個空白回覆:第三個要求的回應,另一個則是空白的回覆。
由於其他使用者編輯了簡報,因此簡報可能不會反映您的變更內容,因為協作者的變更內容可能有所變動。如果沒有協作者,簡報應會反映您所做的變更。無論如何,您要求的更新一律會以不可分割的形式套用。
HTTP 要求
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
這個網址使用 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。 |