- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi ủy quyền
- Yêu cầu
- CreateSlideRequest
- LayoutReference
- được xác định trước
- LayoutplaceholderIdMapping
- CreateShapeRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- Thay thế tất cả văn bản yêu cầu
- Tiêu chuẩn so khớp chuỗi con
- Xóa đối tượng
- UpdatePageElementTransformRequest
- ApplyMode
- Cập nhật trang trình bày về yêu cầu vị trí
- DeleteTextRequest
- Phạm vi
- Loại
- Tạo hình ảnh yêu cầu
- CreateVideoRequest
- Tạo trang tính biểu đồ
- Chế độ liên kết
- CreateLineRequest
- Danh mục
- Làm mới trang tính biểu đồ
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- Tạo paragraphBullets yêu cầu
- BulletGlyphPreset
- Thay thế tất cả hình dạng bằng yêu cầu hình ảnh
- Phương thức thay thế
- ImagereplaceMethod
- DuplicateObjectRequest
- UpdateTextStyleRequest
- Thay thế tất cả hình dạng bằng trang tính biểu đồ
- Chế độ liên kết
- Xoá Đoạn Đạn: Yêu cầu
- Update paragraphStyleRequest
- UpdateTableBorderPropertiesRequest
- Vị trí đường viền
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- Hủy hợp nhất yêu cầu thông báo bảng
- Yêu cầu đối tượng nhóm
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- Thay thế hình ảnh
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- Phản hồi
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- Thay thế tất cả văn bản phản hồi
- Tạo hình ảnh phản hồi
- Tạo VideoResponse
- CreateSheetChartResponse
- Tạo phản hồi Line
- Thay thế tất cả hình dạng bằng phản hồi hình ảnh
- DuplicateObjectResponse
- Thay thế tất cả hình dạng bằng phản hồi trang tính
- Nhóm đối tượng
- Hãy làm thử!
Áp dụng một hoặc nhiều nội dung cập nhật cho bản trình bày.
Mỗi request
đều được xác thực trước khi áp dụng. Nếu bất kỳ yêu cầu nào không hợp lệ thì toàn bộ yêu cầu sẽ không thành công và không có yêu cầu nào được áp dụng.
Một số yêu cầu có replies
để cung cấp cho bạn một số thông tin về cách áp dụng yêu cầu. Các yêu cầu khác không cần trả về thông tin; mỗi yêu cầu trả về một câu trả lời trống. Thứ tự trả lời khớp với thứ tự của các yêu cầu.
Ví dụ: giả sử bạn gọilôUpdateUpdate với bốn bản cập nhật và chỉ bản cập nhật thứ ba trả về thông tin. Phản hồi sẽ có hai phản hồi trống: phản hồi cho yêu cầu thứ ba và một phản hồi trống khác theo thứ tự đó.
Do người dùng khác có thể đang chỉnh sửa bản trình bày nên bản trình bày có thể không phản ánh chính xác các thay đổi của bạn: các thay đổi của bạn có thể bị thay đổi đối với các thay đổi của cộng tác viên. Nếu không có cộng tác viên nào, bản trình bày sẽ phản ánh thay đổi của bạn. Trong mọi trường hợp, nội dung cập nhật trong yêu cầu của bạn đều được đảm bảo áp dụng cùng nhau.
Yêu cầu HTTP
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
presentationId |
Bản trình bày để áp dụng bản cập nhật. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu với cấu trúc như sau:
Biểu diễn dưới dạng JSON |
---|
{ "requests": [ { object ( |
Các trường | |
---|---|
requests[] |
Danh sách các nội dung cập nhật sẽ áp dụng cho bản trình bày. |
writeControl |
Cung cấp quyền kiểm soát cách thực thi yêu cầu ghi. |
Nội dung phản hồi
Thông báo phản hồi từ bản cập nhật theo lô.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "presentationId": string, "replies": [ { object ( |
Các trường | |
---|---|
presentationId |
Bản trình bày có nội dung cập nhật. |
replies[] |
Phản hồi về nội dung cập nhật. Thao tác này sẽ ánh xạ 1:1 với nội dung cập nhật, mặc dù các câu trả lời cho một số yêu cầu có thể trống. |
writeControl |
Chế độ điều khiển ghi đã cập nhật sau khi áp dụng yêu cầu. |
Phạm vi ủy quyền
Yêu cầu một trong các phạm vi OAuth sau:
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
Để biết thêm thông tin, hãy xem Hướng dẫn ủy quyền.
Điều khiển ghi
Cung cấp quyền kiểm soát cách thực thi yêu cầu ghi.
Biểu diễn dưới dạng JSON |
---|
{ "requiredRevisionId": string } |
Các trường | |
---|---|
requiredRevisionId |
Cần có Khi phản hồi được yêu cầu trả lại ID sửa đổi, điều này cho biết ID sửa đổi của tài liệu sau khi yêu cầu được áp dụng. |