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 ความกว้างของภาพขนาดย่อ 1600px
MEDIUM ความกว้างของภาพขนาดย่อ 800px
SMALL ความกว้างของภาพขนาดย่อ 200px