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ề một URL đến 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

Thông 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

Thông số
thumbnailProperties

object (ThumbnailProperties)

Các thuộc tính của 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 ảnh thu nhỏ.

URL của 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ẻ bằng tài khoản của người yêu cầu. Bất kỳ ai có URL này đều có thể truy cập vào hình ảnh đó với tư cách là người yêu cầu ban đầu. Bạn có thể mất quyền truy cập vào hình ảnh nếu chế độ cài đặt chia sẻ của bản trình bày thay đổi. Loại mime của hình thu nhỏ giống như loại đượ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

Cung cấp quyền kiểm soát đối với 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 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 ảnh thu nhỏ được xác định trước. Các giá trị ở đây mô tả chiều rộng của hình thu nhỏ. Khi chiều cao trang lớn hơn chiều rộng, chiều rộng có thể nhỏ hơn kích thước được chỉ định.

Enum
THUMBNAIL_SIZE_UNSPECIFIED

Kích thước hình thu nhỏ mặc định.

Kích thước hình thu nhỏ không được chỉ định ngụ ý rằng máy chủ chọn kích thước của 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.