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

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

integer

ความสูงเป็นพิกเซลของภาพขนาดย่อที่มากกว่า 0
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 พิกเซล