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/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/presentationshttps://www.googleapis.com/auth/presentations.readonly
מידע נוסף זמין במדריך ההרשאות.
ThumbnailProperties
נותן לכם שליטה על יצירת התמונות הממוזערות של הדפים.
| שדות |
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 פיקסלים. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-03-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-03-25 (שעון UTC)."],[],[],null,["# Method: presentations.pages.getThumbnail\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Thumbnail.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ThumbnailProperties](#ThumbnailProperties)\n - [JSON representation](#ThumbnailProperties.SCHEMA_REPRESENTATION)\n- [MimeType](#MimeType)\n- [ThumbnailSize](#ThumbnailSize)\n- [Try it!](#try-it)\n\nGenerates a thumbnail of the latest version of the specified page in the presentation and returns a URL to the thumbnail image.\n\nThis request counts as an [expensive read request](https://developers.google.com/workspace/slides/limits) for quota purposes.\n\n### HTTP request\n\n`GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------|-----------------------------------------------------------------|\n| `presentationId` | `string` The ID of the presentation to retrieve. |\n| `pageObjectId` | `string` The object ID of the page whose thumbnail to retrieve. |\n\n### Query parameters\n\n| Parameters ||\n|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `thumbnailProperties` | `object (`[ThumbnailProperties](/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#ThumbnailProperties)`)` The thumbnail properties. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe thumbnail of a page.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------|\n| ``` { \"width\": integer, \"height\": integer, \"contentUrl\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `width` | `integer` The positive width in pixels of the thumbnail image. |\n| `height` | `integer` The positive height in pixels of the thumbnail image. |\n| `contentUrl` | `string` The content URL of the thumbnail image. The URL to the image has a default lifetime of 30 minutes. This URL is tagged with the account of the requester. Anyone with the URL effectively accesses the image as the original requester. Access to the image may be lost if the presentation's sharing settings change. The mime type of the thumbnail image is the same as specified in the `GetPageThumbnailRequest`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `https://www.googleapis.com/auth/drive.file`\n- `https://www.googleapis.com/auth/drive.readonly`\n- `https://www.googleapis.com/auth/presentations`\n- `https://www.googleapis.com/auth/presentations.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nThumbnailProperties\n-------------------\n\nProvides control over page thumbnail creation.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"mimeType\": enum (/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#MimeType), \"thumbnailSize\": enum (/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#ThumbnailSize) } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `mimeType` | `enum (`[MimeType](/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#MimeType)`)` The optional mime type of the thumbnail image. If you don't specify the mime type, the mime type defaults to PNG. |\n| `thumbnailSize` | `enum (`[ThumbnailSize](/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#ThumbnailSize)`)` The optional thumbnail image size. If you don't specify the size, the server chooses a default size of the image. |\n\nMimeType\n--------\n\nThe mime type of the thumbnail image.\n\n| Enums ||\n|-------|------------------------|\n| `PNG` | The default mime type. |\n\nThumbnailSize\n-------------\n\nThe predefined thumbnail image sizes.\n\n| Enums ||\n|------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `THUMBNAIL_SIZE_UNSPECIFIED` | The default thumbnail image size. The unspecified thumbnail size implies that the server chooses the size of the image in a way that might vary in the future. |\n| `LARGE` | The thumbnail image width of 1600px. |\n| `MEDIUM` | The thumbnail image width of 800px. |\n| `SMALL` | The thumbnail image width of 200px. |"]]
