Method: presentations.pages.getThumbnail

यह फ़ंक्शन, प्रज़ेंटेशन में दिए गए पेज के नए वर्शन का थंबनेल जनरेट करता है. साथ ही, थंबनेल इमेज का यूआरएल दिखाता है.

कोटा के लिए, इस अनुरोध को महंगे ईमेल पढ़ने का अनुरोध माना जाता है.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
presentationId

string

जिस प्रज़ेंटेशन को वापस लाना है उसका आईडी.
pageObjectId

string

उस पेज का ऑब्जेक्ट आईडी जिसका थंबनेल वापस पाना है.

क्वेरी पैरामीटर

पैरामीटर
thumbnailProperties

object (ThumbnailProperties)

थंबनेल की प्रॉपर्टी.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

किसी पेज का थंबनेल.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
फ़ील्ड
width

integer

थंबनेल इमेज की चौड़ाई, पिक्सल में.
height

integer

थंबनेल इमेज की ऊंचाई, पिक्सल में.
contentUrl

string

थंबनेल इमेज का कॉन्टेंट यूआरएल.

इमेज के यूआरएल का डिफ़ॉल्ट लाइफ़टाइम 30 मिनट होता है. यह यूआरएल, अनुरोध करने वाले व्यक्ति के खाते से टैग किया जाता है. जिस किसी के पास भी यूआरएल होगा वह इमेज को उसी तरह ऐक्सेस कर पाएगा जिस तरह अनुरोध करने वाला व्यक्ति करता है. प्रज़ेंटेशन की शेयर करने की सेटिंग में बदलाव होने पर, हो सकता है कि इमेज का ऐक्सेस हट जाए. थंबनेल इमेज का 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)

थंबनेल इमेज का माइम टाइप. हालांकि, यह ज़रूरी नहीं है.

अगर माइम टाइप की जानकारी नहीं दी जाती है, तो माइम टाइप डिफ़ॉल्ट रूप से PNG पर सेट हो जाता है.
thumbnailSize

enum (ThumbnailSize)

थंबनेल की इमेज का साइज़, जो ज़रूरी नहीं है.

साइज़ की जानकारी न देने पर, सर्वर इमेज का डिफ़ॉल्ट साइज़ चुन लेता है.

MimeType

थंबनेल इमेज का MIME टाइप.

Enums
PNG डिफ़ॉल्ट माइम टाइप.

ThumbnailSize

थंबनेल की इमेज के पहले से तय साइज़.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

थंबनेल इमेज का डिफ़ॉल्ट साइज़.

थंबनेल का साइज़ तय न करने का मतलब है कि सर्वर इमेज का साइज़ इस तरह से चुनता है कि वह आने वाले समय में अलग-अलग हो सकता है.
LARGE थंबनेल की इमेज की चौड़ाई 1600 पिक्सल होनी चाहिए.
MEDIUM थंबनेल इमेज की चौड़ाई 800 पिक्सल होनी चाहिए.
SMALL थंबनेल की इमेज की चौड़ाई 200 पिक्सल होनी चाहिए.