- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- ThumbnailProperties
- MimeType
- ThumbnailSize
- Hãy làm thử!
Tạo hình thu nhỏ của phiên bản mới nhất của trang được chỉ định trong bản trình bày và trả về URL cho hình thu nhỏ.
Yêu cầu này được tính là một yêu cầu đọc tốn kém cho mục đích hạn mức.
Yêu cầu HTTP
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
presentationId |
Mã của bản trình bày cần truy xuất. |
pageObjectId |
Mã đối tượng của trang có hình thu nhỏ cần truy xuất. |
Tham số truy vấn
Tham số | |
---|---|
thumbnailProperties |
Thuộc tính hình thu nhỏ. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Hình thu nhỏ của một trang.
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 |
---|
{ "width": integer, "height": integer, "contentUrl": string } |
Trường | |
---|---|
width |
Chiều rộng dương tính bằng pixel của hình thu nhỏ. |
height |
Chiều cao dương tính bằng pixel của hình thu nhỏ. |
contentUrl |
URL nội dung của hình thu nhỏ. URL dẫn đến hình ảnh có thời gian tồn tại mặc định là 30 phút. URL này được gắn thẻ với tài khoản của người yêu cầu. Bất kỳ ai có URL đều truy cập hiệu quả vào hình ảnh với tư cách là người yêu cầu ban đầu. Quyền truy cập vào hình ảnh có thể bị mất nếu chế độ cài đặt cách chia sẻ của bản trình bày thay đổi. Loại MIME của hình thu nhỏ tương tự như chỉ định trong |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
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/presentations.readonly
Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.
ThumbnailProperties
Giúp kiểm soát việc tạo hình thu nhỏ của trang.
Biểu diễn dưới dạng JSON |
---|
{ "mimeType": enum ( |
Trường | |
---|---|
mimeType |
Loại MIME không bắt buộc của hình thu nhỏ. Nếu bạn không chỉ định loại MIME, thì loại MIME sẽ mặc định là PNG. |
thumbnailSize |
Kích thước hình ảnh thu nhỏ không bắt buộc. Nếu bạn không chỉ định kích thước, máy chủ sẽ chọn kích thước mặc định của hình ảnh. |
MimeType
Loại MIME của hình thu nhỏ.
Enum | |
---|---|
PNG |
Loại MIME mặc định. |
ThumbnailSize
Kích thước hình thu nhỏ được xác định trước.
Enum | |
---|---|
THUMBNAIL_SIZE_UNSPECIFIED |
Kích thước hình ảnh thu nhỏ mặc định. Kích thước hình thu nhỏ không xác định ngụ ý rằng máy chủ chọn kích thước hình ảnh theo cách có thể thay đổi trong tương lai. |
LARGE |
Chiều rộng hình thu nhỏ là 1600px. |
MEDIUM |
Chiều rộng hình thu nhỏ là 800 px. |
SMALL |
Chiều rộng hình thu nhỏ là 200 px. |