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

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

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

enum (ThumbnailSize)

थंबनेल इमेज का साइज़. यह विकल्प के तौर पर उपलब्ध है.

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

MimeType

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

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

ThumbnailSize

थंबनेल इमेज के पहले से तय किए गए साइज़. यहां दी गई वैल्यू से, थंबनेल इमेज की चौड़ाई के बारे में पता चलता है. जब पेज की लंबाई, चौड़ाई से ज़्यादा होती है, तो चौड़ाई तय किए गए साइज़ से कम हो सकती है.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

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

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