Method: presentations.pages.getThumbnail

יוצרת תמונה ממוזערת של הגרסה האחרונה של הדף שצוין במצגת ומחזירה כתובת URL לתמונה הממוזערת.

הבקשה הזו נחשבת לבקשת קריאה יקרה לצורך חישוב המכסה.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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, ברירת המחדל היא PNG.
thumbnailSize

enum (ThumbnailSize)

גודל התמונה הממוזערת האופציונלית.

אם לא מציינים את הגודל, השרת בוחר גודל ברירת מחדל לתמונה.

MimeType

סוג ה-MIME של התמונה הממוזערת.

טיפוסים בני מנייה (enum)
PNG סוג ה-MIME שמוגדר כברירת מחדל.

ThumbnailSize

גדלי התמונות הממוזערות שמוגדרים מראש. הערכים כאן מתארים את הרוחב של התמונה הממוזערת. אם גובה הדף גדול מהרוחב, יכול להיות שהרוחב יהיה קטן מהגודל שצוין.

טיפוסים בני מנייה (enum)
THUMBNAIL_SIZE_UNSPECIFIED

גודל ברירת המחדל של התמונה הממוזערת.

הגודל הלא מוגדר של התמונה הממוזערת מרמז שהשרת בוחר את גודל התמונה באופן שעשוי להשתנות בעתיד.
LARGE רוחב התמונה הממוזערת הוא 1,600 פיקסלים.
MEDIUM רוחב התמונה הממוזערת הוא 800 פיקסלים.
SMALL הרוחב של התמונה הממוזערת הוא 200 פיקסלים.