Method: presentations.pages.getThumbnail

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

string

Mã của bản trình bày cần truy xuất.
pageObjectId

string

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

object (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

integer

Chiều rộng dương tính bằng pixel của hình thu nhỏ.
height

integer

Chiều cao dương tính bằng pixel của hình thu nhỏ.
contentUrl

string

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 GetPageThumbnailRequest.

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 (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Trường
mimeType

enum (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

enum (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.