- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- ThumbnailProperties
- MimeType
- ThumbnailSize
- רוצים לנסות?
יוצר תמונה ממוזערת של הגרסה האחרונה של הדף שצוין במצגת, ומחזיר כתובת אתר לתמונה הממוזערת.
הבקשה הזו נחשבת כבקשת קריאה יקרה למטרות מכסה.
בקשת HTTP
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
presentationId |
מזהה המצגת שצריך לאחזר. |
pageObjectId |
מזהה האובייקט של הדף שיש לאחזר את התמונה הממוזערת שלו. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
thumbnailProperties |
מאפייני התמונה הממוזערת. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
התמונה הממוזערת של הדף.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "width": integer, "height": integer, "contentUrl": string } |
שדות | |
---|---|
width |
הרוחב החיובי בפיקסלים של התמונה הממוזערת. |
height |
הגובה החיובי בפיקסלים של התמונה הממוזערת. |
contentUrl |
כתובת ה-URL של התוכן של התמונה הממוזערת. כברירת מחדל, לכתובת ה-URL של התמונה יש משך חיים של 30 דקות. כתובת ה-URL הזו מתויגת בחשבון של מגיש הבקשה. כל מי שיש לו את כתובת ה-URL ניגש באופן אפקטיבי לתמונה בתור המבקש המקורי. אם הגדרות השיתוף של המצגת ישתנו, אתם עלולים לאבד את הגישה לתמונה. סוג ה-MIME של התמונה הממוזערת זהה לסוג שצוין ב- |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של 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 |
סוג ה-MIME האופציונלי של התמונה הממוזערת. אם לא תציינו את סוג ה-MIME, ברירת המחדל של סוג ה-MIME תהיה PNG. |
thumbnailSize |
הגודל האופציונלי של התמונה הממוזערת. אם לא תציינו את הגודל, השרת יבחר את גודל ברירת המחדל של התמונה. |
MimeType
סוג ה-MIME של התמונה הממוזערת.
טיפוסים בני מנייה (enums) | |
---|---|
PNG |
סוג ברירת המחדל של MIME. |
ThumbnailSize
גדלים מוגדרים מראש של תמונות ממוזערות.
טיפוסים בני מנייה (enums) | |
---|---|
THUMBNAIL_SIZE_UNSPECIFIED |
גודל ברירת המחדל של תמונה ממוזערת. הגודל של התמונה הממוזערת שלא צוין מרמז על כך שהשרת בוחר את גודל התמונה באופן שעשוי להשתנות בעתיד. |
LARGE |
רוחב התמונה הממוזערת הוא 1,600 פיקסלים. |
MEDIUM |
רוחב התמונה הממוזערת הוא 800 פיקסלים. |
SMALL |
רוחב התמונה הממוזערת הוא 200 פיקסלים. |