Method: presentations.pages.getThumbnail

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
presentationId

string

वापस पाने के लिए प्रज़ेंटेशन का आईडी.

pageObjectId

string

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

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

पैरामीटर
thumbnailProperties

object (ThumbnailProperties)

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

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

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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

पेज थंबनेल बनाने के लिए कंट्रोल उपलब्ध कराता है.

जेएसओएन के काेड में दिखाना
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
फ़ील्ड
mimeType

enum (MimeType)

थंबनेल इमेज का वैकल्पिक MIME टाइप.

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

thumbnailSize

enum (ThumbnailSize)

थंबनेल की इमेज का वैकल्पिक साइज़.

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

MimeType

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

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

ThumbnailSize

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

Enums
THUMBNAIL_SIZE_UNSPECIFIED

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

थंबनेल के साइज़ की जानकारी न होने का मतलब है कि सर्वर, इमेज के साइज़ को इस हिसाब से चुनता है कि आने वाले समय में इमेज का साइज़ बदला जा सकता है.

LARGE थंबनेल इमेज की चौड़ाई 1600 पिक्सल है.
MEDIUM थंबनेल इमेज की चौड़ाई 800 पिक्सल है.
SMALL थंबनेल इमेज की चौड़ाई 200 पिक्सल.