थंबनेल की मदद से, लोगों को काम के खोज नतीजे ढूंढने में मदद मिलती है. इनकी ये विशेषताएं हैं:
- चौड़ाई 1024 पिक्सल हो.
- Google Workspace फ़ाइल के थंबनेल के यूआरएल, एएलसी से सुरक्षित होते हैं. अन्य फ़ाइल टाइप काम नहीं करते.
- यूआरएल, पांच मिनट बाद काम नहीं करते.
- जनरेट करने के लिए, फ़ाइल का साइज़ 50 एमबी से ज़्यादा नहीं होना चाहिए.
- अगर जवाब जनरेट नहीं हो पाता है, तो Cloud Search एक प्लेसहोल्डर आइकॉन दिखाता है. Google Workspace के आइटम के लिए, यूआरएल "404 Not Found" दिखाता है. आपके ऐप्लिकेशन को इसे मैनेज करना होगा.
Google Drive, Docs, Sheets, और Slides जैसे फ़ाइल टाइप के लिए थंबनेल अपने-आप बनाता है. Cloud Search इन फ़ाइलों के लिए भी थंबनेल जनरेट करता है:
- Microsoft Word (DOC, DOCX)
- Microsoft Excel (XLS, XLSX)
- Microsoft PowerPoint (PPT, PPTX)
- Adobe PDF
- RTF, TXT, HTML, और XML
Cloud Search, सिर्फ़ तब आइटम के थंबनेल दिखाता है, जब आपने डेटा सोर्स और सर्च ऐप्लिकेशन के लिए थंबनेल दिखाने की सुविधा चालू की हो.
किसी डेटा सोर्स के लिए थंबनेल यूआरएल चालू करना
थंबनेल के यूआरएल चालू करने के लिए, एपीआई कुंजी और वेब ऐप्लिकेशन क्रेडेंशियल बनाएं. इनका इस्तेमाल करके, अपने डेटा सोर्स को अपडेट करने के लिए ऐक्सेस टोकन पाएं.
- कोई प्रोजेक्ट बनाएं या चुनें और एपीआई चालू करें. Cloud Search API का ऐक्सेस कॉन्फ़िगर करना लेख पढ़ें.
- Google Cloud Console में एक एपीआई पासकोड बनाएं और उसकी वैल्यू नोट करें.
- वेब ऐप्लिकेशन के क्रेडेंशियल बनाएं. रीडायरेक्ट यूआरआई के तौर पर,
https://developers.google.com/oauthplaygroundका इस्तेमाल करें. क्रेडेंशियल बनाना लेख पढ़ें. - OAuth 2.0 Playground में जाकर, OAuth 2.0 कॉन्फ़िगरेशन खोलें.
- अपने क्रेडेंशियल इस्तेमाल करें को चुनें. इसके बाद, अपना क्लाइंट आईडी और सीक्रेट डालें.
- स्कोप फ़ील्ड में
https://www.googleapis.com/auth/cloud_search.settingsडालें और एपीआई को अनुमति दें पर क्लिक करें. - ऑथराइज़ेशन कोड को टोकन के लिए बदलें.
अपना डेटा सोर्स आईडी पाने के लिए,
settings.datasources.getको कॉल करें:curl 'https://cloudsearch.googleapis.com/v1/settings/DATASOURCE_ID?key=YOUR_API_KEY' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'Accept: application/json' \ --compressedreturnThumbnailUrlsकोtrueपर सेट करके,settings.datasources.updateको कॉल करें:curl --request PUT \ 'https://cloudsearch.googleapis.com/v1/settings/datasources/DATASOURCE_ID?key=YOUR_API_KEY' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{"source":{"name":"datasources/DATASOURCE_ID","displayName":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \ --compressed
खोज वाले किसी ऐप्लिकेशन के लिए, थंबनेल के यूआरएल चालू करना
आपको अपने सर्च ऐप्लिकेशन में थंबनेल दिखाने की सुविधा भी चालू करनी होगी.
- पिछले सेक्शन में बताए गए तरीके का इस्तेमाल करके, एपीआई कुंजी और ऐक्सेस टोकन पाएं.
अपना ऐप्लिकेशन आईडी पाने के लिए,
settings.searchapplications.getपर कॉल करें:curl 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'Accept: application/json' \ --compressedreturnResultThumbnailUrlsका इस्तेमाल करकेsettings.searchapplications.updateको कॉल करो औरtrueपर सेट करो:curl --request PUT \ 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{"name":"searchapplications/APP_ID","displayName":"DISPLAY_NAME","dataSourceRestrictions":[{"source":{"name":"datasources/DATASOURCE_ID"}}],"returnResultThumbnailUrls":true}' \ --compressed
थंबनेल ऐक्सेस करना
Drive फ़ाइल के थंबनेल को ऐक्सेस करने के लिए, उपयोगकर्ता या ऐप्लिकेशन को उसी खाते के क्रेडेंशियल का इस्तेमाल करना होगा जिसका इस्तेमाल ओरिजनल आइटम को ऐक्सेस करने के लिए किया गया था.