API Google Trang trình bày cho phép bạn tạo, di chuyển và xoá trang trình bày. Ví dụ về
trang này trình bày một số thao tác phổ biến trên trang trình bày bằng cách sử dụng
presentations.batchUpdate
.
Những ví dụ này sử dụng các biến sau:
- PRESENTATION_ID – Cho biết nơi bạn cung cấp bản trình bày Mã nhận dạng. Bạn có thể khám phá giá trị cho mã nhận dạng này từ URL của bản trình bày.
- PAGE_ID và PAGE_ID2 – Cho biết vị trí bạn cung cấp đối tượng trang Mã nhận dạng. Bạn có thể truy xuất giá trị cho việc này từ URL hoặc bằng cách sử dụng yêu cầu đọc API.
Những ví dụ này được trình bày dưới dạng yêu cầu HTTP nhằm đảm bảo trung lập về ngôn ngữ. Để tìm hiểu cách triển khai việc cập nhật theo lô bằng nhiều ngôn ngữ bằng Google API thư viện ứng dụng, hãy xem các hướng dẫn sau: Tạo một trang trình bày và Thêm hình dạng và văn bản.
Sao chép trang trình bày
Nội dung sau đây
presentations.batchUpdate
mã mẫu cho biết cách sử dụng
DuplicateObjectRequest
để sao chép một trang trình bày và chèn nó vào sau bản gốc trong bản trình bày.
Trang trình bày gốc do PAGE_ID chỉ định.
Yêu cầu này cho phép bạn chỉ định xem sẽ có một số hay tất cả mã phần tử trang trong bản sao (với một số bản sao hạn chế). Trong ví dụ này, trang trình bày ban đầu chứa một phần tử bảng (được chỉ định bởi TABLE_ELEMENT_ID), được ánh xạ tới một bảng mới (được chỉ định bởi COPY_TABLE_ELEMENT_ID) trong bản sao trang trình bày (được chỉ định bởi COPY_PAGE_ID). Tất cả các phần tử khác trên bản sao được cung cấp ngẫu nhiên Mã nhận dạng.
Để biết thêm thông tin về việc sao chép
PageElement
,
bao gồm hộp văn bản, hình ảnh, bảng, hình dạng cơ bản, đường kẻ và video được nhúng,
xem mẫu Sao chép và chỉnh sửa
.
Sau đây là giao thức yêu cầu sao chép trang trình bày:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ID, "objectIds": { "PAGE_ID": "COPY_PAGE_ID", "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID" } } } ] }
Tạo trang trình bày
Nội dung sau đây
presentations.batchUpdate
mã mẫu cho biết cách sử dụng
CreateSlideRequest
để tạo một trang trình bày và chèn trang trình bày đó làm trang trình bày thứ tư (sử dụng phương pháp dựa trên giá trị 0
insertionIndex
) trong bản trình bày.
Trang trình bày mới sẽ sử dụng
PredefinedLayout
trong tổng số TITLE_AND_TWO_COLUMNS
. Bạn có thể chỉ định một chuỗi để sử dụng làm
PAGE_ID cho trang trình bày (với một số
hạn chế),
hoặc cho phép API tạo PAGE_ID bằng cách bỏ trường này
trong yêu cầu.
Sau đây là giao thức yêu cầu tạo trang trình bày:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": "PAGE_ID", "insertionIndex": 3, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" } } } ] }
Tạo trang trình bày và sửa đổi phần giữ chỗ
Nội dung sau đây
presentations.batchUpdate
mã mẫu cho biết cách sử dụng
CreateSlideRequest
để tạo trang trình bày bằng cách sử dụng
PredefinedLayout
trong tổng số TITLE_AND_TWO_COLUMNS
.
Bạn có thể chỉ định một chuỗi làm PAGE_ID cho trang trình bày
(với một số người dùng
hạn chế).
Chiến lược phát hành đĩa đơn
placeholderIdMappings
sử dụng
Type
trong số
TITLE
. TITLE_ID tham chiếu đến hình dạng phần giữ chỗ của trang trình bày
để có thể sửa đổi.
Sau đây là giao thức yêu cầu tạo trang trình bày và sửa đổi phần giữ chỗ:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
Di chuyển các trang trình bày đến một vị trí mới
Nội dung sau đây
presentations.batchUpdate
mã mẫu cho biết cách sử dụng
UpdateSlidesPositionRequest
để lấy hai trang trình bày cụ thể và di chuyển chúng vào đầu
để duy trì thứ tự tương đối.
Mã trang trình bày được chỉ định (PAGE_ID và PAGE_ID2)
phải được cung cấp theo thứ tự bản trình bày hiện có, không trùng lặp. Chiến lược phát hành đĩa đơn
insertionIndex
dựa trên giá trị 0 biểu thị vị trí các trang trình bày sẽ được chèn vào, dựa trên
đối với đơn đặt hàng trước khi quá trình di chuyển diễn ra. Giá trị phải nằm trong khoảng từ 0 đến
số lượng trang trình bày trong bản trình bày.
Sau đây là giao thức yêu cầu di chuyển trang trình bày sang một vị trí mới:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateSlidesPosition": { "slideObjectIds": [ PAGE_ID, PAGE_ID2 ], "insertionIndex": 0 } } ] }
Đặt hình nền cho trang trình bày
Nội dung sau đây
presentations.batchUpdate
mã mẫu cho biết cách sử dụng
UpdatePagePropertiesRequest
để đặt hình nền của một trang trình bày được chỉ định bởi
PAGE_ID. API truy xuất hình ảnh bằng cách sử dụng
IMAGE_URL.
Mặt nạ trường được dùng để chỉ định rằng chỉ nền của trang trình bày sẽ được thay đổi để giữ lại các thuộc tính khác. Sử dụng trường khẩu trang cũng cải thiện hiệu suất.
Ngoài ra, bạn có thể sử dụng phương thức UpdatePagePropertiesRequest
để đặt giá trị
nền của trang trình bày thành màu đồng nhất.
Sau đây là giao thức yêu cầu đặt hình nền trang trình bày:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageProperties": { "objectId": PAGE_ID, "pageProperties": { "pageBackgroundFill": { "stretchedPictureFill": { "contentUrl": IMAGE_URL } } }, "fields": "pageBackgroundFill" } } ] }
Tạo hình thu nhỏ
Bạn có thể tạo hình thu nhỏ của phiên bản mới nhất của một trang cụ thể trong
bằng cách gọi phương thức
presentations.pages.getThumbnail
, phương thức này sẽ trả về hình thu nhỏ của trang dưới dạng URL nội dung. Hình ảnh
URL có thời gian tồn tại mặc định là 30 phút.
Bạn cũng có thể chỉ định mimeType
và thumbnailSize
được trả về bằng cách sử dụng phương thức
ThumbnailProperties
dưới dạng tham số truy vấn.
Sau đây là giao thức yêu cầu để tạo hình thu nhỏ của trang bằng
Tập hợp ThumbnailProperties
:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{ "width": 800, "height": 450, "contentUrl": "CONTENT_URL" }