Method: presentations.pages.getThumbnail

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
  • ייצוג JSON
• היקפי ההרשאות
• ThumbnailProperties
  • ייצוג JSON
• MimeType
• ThumbnailSize
• רוצים לנסות?

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

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

בקשת 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 של התמונה הממוזערת.

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

ThumbnailSize

גדלים מוגדרים מראש של תמונות ממוזערות.

טיפוסים בני מנייה (enums)
THUMBNAIL_SIZE_UNSPECIFIED	גודל ברירת המחדל של תמונה ממוזערת. הגודל של התמונה הממוזערת שלא צוין מרמז על כך שהשרת בוחר את גודל התמונה באופן שעשוי להשתנות בעתיד.
LARGE	רוחב התמונה הממוזערת הוא 1,600 פיקסלים.
MEDIUM	רוחב התמונה הממוזערת הוא 800 פיקסלים.
SMALL	רוחב התמונה הממוזערת הוא 200 פיקסלים.