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 ả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 của 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ã nhận dạng 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)

Các 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 tới 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ả 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ỏ giống như được chỉ định trong GetPageThumbnailRequest.

Phạm vi uỷ 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/presentations.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

ThumbnailProperties

Cho phép kiểm soát việc tạo hình thu nhỏ 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 ảnh thu nhỏ.

Nếu bạn không chỉ định loại mime, loại mime sẽ mặc định là PNG.

thumbnailSize

enum (ThumbnailSize)

Kích thước hình thu nhỏ tuỳ chọn.

Nếu bạn không chỉ định kích thước, máy chủ sẽ chọn một 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 thu nhỏ mặc định.

Kích thước hình thu nhỏ chưa được chỉ đị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à 1600 px.
MEDIUM Chiều rộng hình thu nhỏ là 800 px.
SMALL Chiều rộng hình thu nhỏ là 200 px.