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 đến hình thu nhỏ.

Yêu cầu này được tính là 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ã nhận dạng đố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)

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 tính bằng pixel của hình thu nhỏ.
height

integer

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

string

URL nội dung của hình thu nhỏ.

URL đế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 này đều có thể truy cập vào hình ảnh dưới vai trò 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 với loại đã 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ỏ 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 mặc định sẽ 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 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ỏ không được chỉ định có nghĩa là 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à 800px.
SMALL Chiều rộng hình thu nhỏ là 200px.