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 פיקסלים.