Method: presentations.pages.getThumbnail

สร้างภาพขนาดย่อของหน้าเวอร์ชันล่าสุดที่ระบุในงานนำเสนอ และแสดง URL ของรูปภาพขนาดย่อ

คำขอนี้ถือเป็นคำขออ่านที่มีค่าใช้จ่ายสูงเพื่อวัตถุประสงค์ด้านโควต้า

คำขอ HTTP

GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
presentationId

string

รหัสของงานนำเสนอที่จะดึงข้อมูล
pageObjectId

string

รหัสออบเจ็กต์ของหน้าที่ต้องการดึงภาพขนาดย่อ

พารามิเตอร์การค้นหา

พารามิเตอร์
thumbnailProperties

object (ThumbnailProperties)

พร็อพเพอร์ตี้ของภาพขนาดย่อ

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ภาพขนาดย่อของหน้า

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
ช่อง
width

integer

ความกว้างที่เป็นบวกในหน่วยพิกเซลของภาพขนาดย่อ
height

integer

ความสูงที่เป็นบวกของรูปภาพขนาดย่อในหน่วยพิกเซล
contentUrl

string

URL เนื้อหาของภาพขนาดย่อ

URL ของรูปภาพมีอายุเริ่มต้น 30 นาที URL นี้ติดแท็กด้วยบัญชีของผู้ขอ ทุกคนที่มี URL จะเข้าถึงรูปภาพได้เหมือนกับผู้ขอต้นฉบับ คุณอาจสูญเสียสิทธิ์เข้าถึงรูปภาพหากการตั้งค่าการแชร์ของงานนำเสนอมีการเปลี่ยนแปลง ประเภท MIME ของรูปภาพขนาดย่อจะเหมือนกับที่ระบุใน GetPageThumbnailRequest

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • 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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์

ThumbnailProperties

ช่วยให้ควบคุมการสร้างภาพปกของหน้าเว็บได้

การแสดง JSON 
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
ช่อง
mimeType

enum (MimeType)

ประเภท MIME ของรูปภาพขนาดย่อ (ไม่บังคับ)

หากไม่ได้ระบุประเภท MIME ประเภท MIME จะมีค่าเริ่มต้นเป็น PNG
thumbnailSize

enum (ThumbnailSize)

ขนาดภาพขนาดย่อที่ไม่บังคับ

หากไม่ระบุขนาด เซิร์ฟเวอร์จะเลือกขนาดเริ่มต้นของรูปภาพ

MimeType

ประเภท MIME ของรูปภาพขนาดย่อ

Enum
PNG ประเภท MIME เริ่มต้น

ThumbnailSize

ขนาดรูปภาพขนาดย่อที่กำหนดไว้ล่วงหน้า ค่าที่นี่อธิบายความกว้างของรูปภาพปก เมื่อความสูงของหน้าเว็บมากกว่าความกว้าง ความกว้างอาจน้อยกว่าขนาดที่ระบุ

Enum
THUMBNAIL_SIZE_UNSPECIFIED

ขนาดรูปภาพขนาดย่อเริ่มต้น

ขนาดภาพปกที่ไม่ได้ระบุหมายความว่าเซิร์ฟเวอร์จะเลือกขนาดของรูปภาพในลักษณะที่อาจแตกต่างกันในอนาคต
LARGE ความกว้างของภาพปกที่ 1600 พิกเซล
MEDIUM ความกว้างของรูปภาพปก 800 พิกเซล
SMALL ความกว้างของภาพขนาดย่อ 200 พิกเซล