- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- ThumbnailProperties
- MimeType
- ThumbnailSize
- רוצים לנסות?
יוצרת תמונה ממוזערת של הגרסה האחרונה של הדף שצוין במצגת, ומחזירה כתובת URL לתמונה הממוזערת.
הבקשה הזו נחשבת כבקשת קריאה יקרה למטרות מכסה.
בקשת 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 של התמונה הממוזערת.
טיפוסים בני מנייה (enum) | |
---|---|
PNG |
סוג MIME שמוגדר כברירת מחדל. |
ThumbnailSize
גדלים מוגדרים מראש של תמונות ממוזערות.
טיפוסים בני מנייה (enum) | |
---|---|
THUMBNAIL_SIZE_UNSPECIFIED |
גודל ברירת המחדל של התמונה הממוזערת. גודל התמונה הממוזערת שלא צוין מרמז על כך שהשרת בוחר את גודל התמונה באופן שעשוי להשתנות בעתיד. |
LARGE |
רוחב התמונה הממוזערת הוא 1600 פיקסלים. |
MEDIUM |
רוחב התמונה הממוזערת הוא 800 פיקסלים. |
SMALL |
רוחב התמונה הממוזערת הוא 200 פיקסלים. |