Method: presentations.pages.getThumbnail

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

הבקשה הזו נספרת כבקשת קריאה יקרה למטרות מכסה.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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 רוחב התמונה הממוזערת הוא 1,600 פיקסלים.
MEDIUM רוחב התמונה הממוזערת הוא 800 פיקסלים.
SMALL רוחב התמונה הממוזערת הוא 200 פיקסלים.