- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- 请求
- 创建幻灯片请求
- LayoutReference
- 预定义的布局
- LayoutplaceholderIdMapping
- CreateShapeRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnsRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- ReplaceAllTextRequest
- 子字符串匹配条件
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode
- UpdateSlidesPositionRequest
- DeleteTextRequest
- 范围
- 类型
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- 链接模式
- CreateLineRequest
- 类别
- RefreshSheetsChartRequest
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletsRequest
- BulletGlyphPreset
- ReplaceAllShapesWithImageRequest
- 替换方法
- ImageReplaceMethod
- DuplicateObjectRequest
- UpdateTextStyleRequest
- ReplaceAllShapesWithSheetsChartRequest
- 链接模式
- DeleteParagraphBulletsRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- 边框位置
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- ReplaceImageRequest
- UpdateSlidePropertiesRequest
- UpdatePageElementZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- 写入控件
- 响应
- 创建幻灯片响应
- CreateShapeResponse
- CreateTableResponse
- ReplaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- ReplaceAllShapesWithImageResponse
- DuplicateObjectResponse
- ReplaceAllShapesWithSheetsChartResponse
- GroupObjectsResponse
- 试试看!
对演示文稿应用一项或多项更新。
系统会在应用前验证每个 request
。如果任何请求无效,则整个请求将会失败,并且不会应用任何内容。
有些请求会提供 replies
,以便为您提供一些有关它们如何应用的信息。其他请求不需要返回信息;每个请求都会返回一个空回复。回复的顺序与请求的顺序一致。
例如,假设您调用批处理更新涉及四个更新,并且只有第三个更新返回信息。回复会有两个空白回复:依次回复第三个请求和另一个空白回复。
由于其他用户可能正在编辑演示文稿,因此该演示文稿可能无法准确反映您的更改:您的更改可能会因协作者所做的更改而发生变化。如果没有协作者,则该演示文稿应反映您的更改。在任何情况下,都可确保请求中的更新以原子方式同时应用。
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。 |