थंबनेल चालू करें

खोज के नतीजों में दिखने वाले दस्तावेज़ों के लिए थंबनेल दिखाए जाते हैं. थंबनेल की मदद से, उपयोगकर्ता को यह पता चलता है कि खोज के नतीजों में दिखाए गए दस्तावेज़ उसके काम के हैं या नहीं. थंबनेल में ये चीज़ें होनी चाहिए:

  • चौड़ाई 1024 पिक्सल होनी चाहिए.
  • Google Workspace फ़ाइल के थंबनेल का यूआरएल, एसीएल (सभी के लिए अनुमति) से सुरक्षित होता है. अन्य फ़ाइल टाइप के लिए यूआरएल, एसीएल से सुरक्षित नहीं है
  • यूआरएल पांच मिनट के बाद अमान्य हो जाते हैं.
  • 50 एमबी से बड़ी फ़ाइलों के लिए थंबनेल जनरेट नहीं किए जाते.
  • अगर थंबनेल जनरेट नहीं हो पाता है, तो प्लेसहोल्डर आइकॉन का इस्तेमाल किया जाता है. अगर Google Workspace के किसी आइटम का थंबनेल जनरेट नहीं हो पाता है, तो थंबनेल यूआरएल "404 नहीं मिला" दिखाता है. आपके ऐप्लिकेशन को इस तरह के व्यवहार को मैनेज करना चाहिए.

Google Drive में मौजूद उन फ़ाइलों के लिए थंबनेल अपने-आप बन जाते हैं जिनमें थंबनेल की सुविधा काम करती है. जैसे, Google Workspace के दस्तावेज़ टाइप (Docs, Sheets, Slides वगैरह). इसके अलावा, Cloud Search इन फ़ाइल टाइप के लिए अपने-आप थंबनेल बनाता है:

  • Microsoft Word (DOC)
  • Microsoft Word (DOCX)
  • Microsoft Excel (XLS)
  • Microsoft Excel (XLSX)
  • Microsoft Powerpoint (PPT)
  • Microsoft Powerpoint (PPTX)
  • Adobe Portable Document Format (PDF)
  • रिच टेक्स्ट फ़ॉर्मैट (RTF)
  • टेक्स्ट फ़ॉर्मैट (TXT)
  • हाइपरटेक्स्ट मार्कअप लैंग्वेज (एचटीएमएल)
  • एक्सटेंसिबल मार्कअप लैंग्वेज (एक्सएमएल)

थंबनेल सिर्फ़ उन आइटम के लिए दिखाए जाते हैं जिनके डेटा सोर्स और खोज ऐप्लिकेशन में, थंबनेल दिखाने की सुविधा चालू हो.

किसी डेटा सोर्स के लिए थंबनेल यूआरएल चालू करना

आपके Cloud Search Platform प्रोजेक्ट में सेवा खाते के क्रेडेंशियल मौजूद हैं. हालांकि, थंबनेल के यूआरएल चालू करने के लिए, आपको एपीआई पासकोड और वेब ऐप्लिकेशन क्रेडेंशियल बनाने होंगे. साथ ही, ऐक्सेस टोकन पाने के लिए वेब ऐप्लिकेशन क्रेडेंशियल का इस्तेमाल करना होगा. आखिर में, इन क्रेडेंशियल का इस्तेमाल करके, डेटा सोर्स को ऐक्सेस और अपडेट किया जाता है.

  1. अगर आपने अब तक अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट नहीं बनाया है, तो कोई प्रोजेक्ट बनाएं या कोई मौजूदा प्रोजेक्ट चुनें और एपीआई को चालू करें. इन दो चरणों के बारे में जानने के लिए, Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करना लेख में पहला और दूसरा चरण देखें.
  2. एपीआई पासकोड बनाएं:
    1. Google Cloud Console में, क्रेडेंशियल बनाएं ड्रॉप-डाउन सूची पर क्लिक करें और एपीआई पासकोड चुनें. "एपीआई पासकोड बनाया गया" पेज दिखेगा.
    2. एपीआई पासकोड नोट करें.
    3. बंद करें पर क्लिक करें. नया क्रेडेंशियल, "एपीआई कुंजियां" में दिखता है.
  3. वेब ऐप्लिकेशन के क्रेडेंशियल बनाएं. रीडायरेक्ट यूआरआई के तौर पर, https://developers.google.com/oauthplayground का इस्तेमाल करें. . ये क्रेडेंशियल बनाने का तरीका जानने के लिए, वेब ऐप्लिकेशन क्रेडेंशियल (क्लाइंट-साइड JavaScript) बनाना लेख पढ़ें.
  4. OAuth 2.0 प्लैटफ़ॉर्म में, OAuth 2.0 कॉन्फ़िगरेशन पर क्लिक करें.
  5. अपने क्रेडेंशियल इस्तेमाल करें पर सही का निशान लगाएं.
  6. तीसरे चरण में जनरेट किया गया क्लाइंट आईडी और क्लाइंट सीक्रेट डालें.
  7. दायरों वाले फ़ील्ड में, https://www.googleapis.com/auth/cloud_search.settings लिखें और एपीआई को अनुमति दें पर क्लिक करें.
  8. (ज़रूरी नहीं) अगर आपको साइन इन करने की स्क्रीन दिखती है, तो इस्तेमाल करने के लिए कोई खाता चुनें.
  9. (ज़रूरी नहीं) अगर आपको अनुमति देने के लिए कोई स्क्रीन दिखती है, तो स्वीकार करें पर क्लिक करें.
  10. टोकन के लिए ऑथराइज़ेशन कोड बदलें पर क्लिक करें. एक टोकन दिखाया जाता है.
  11. वह डेटा सोर्स चुनें जिसके लिए आपको थंबनेल कंट्रोल चालू करने हैं.

  12. डेटा सोर्स का आईडी पाने के लिए, 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'  \
--compressed

    कहां:

    • datasource_id, उस डेटा सोर्स का नाम है जिसे वापस लाना है.
    • YOUR_API_KEY आपके प्रोजेक्ट का एपीआई पासकोड है. इसे दूसरे चरण में पाया जाता है.
    • YOUR_ACCESS_TOKEN आपके प्रोजेक्ट के लिए OAuth 2.0 ऐक्सेस टोकन है. इसे 10वें चरण से हासिल किया जाता है.

    इस निर्देश का नतीजा कुछ ऐसा दिखता है:

    {
 "source": {
   "name": "datasources/datasource_id",
   "displayName": "DataSource_Display_Name",
   "itemsVisibility": [
     {
       "gsuiteDomain": true
     }
   ]
 }
}

  13. डेटा सोर्स के लिए थंबनेल यूआरएल चालू करने के लिए, returnThumbnailUrls को true पर सेट करके setting.datasource.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":"DataSource_Display_Name","itemsVisibility":
    [{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
  --compressed

    कहां:

    • datasource_id, उस डेटा सोर्स का आईडी होता है जिसे आपको वापस लाना है.
    • YOUR_API_KEY आपके प्रोजेक्ट का एपीआई पासकोड है. इसे दूसरे चरण में पाया जाता है.
    • YOUR_ACCESS_TOKEN आपके प्रोजेक्ट के लिए OAuth 2.0 ऐक्सेस टोकन है. इसे 10वें चरण से हासिल किया जाता है.
    • DataSource_DisplayName, पिछले cURL कमांड से मिला डिसप्ले नेम है.
    • "returnThumbnailsUrls":true, थंबनेल की सुविधा चालू करता है.

    इस निर्देश का नतीजा कुछ ऐसा दिखता है:

    {
  "source": {
    "name": "datasources/datasource_id",
    "displayName": "DataSource_Display_Name",
    "itemsVisibility": [
      {
        "gsuiteDomain": true
      }
    ],
    "returnThumbnailUrls": true
  }
}

खोज ऐप्लिकेशन के लिए थंबनेल यूआरएल चालू करना

आपके Cloud Search Platform प्रोजेक्ट में सेवा खाते के क्रेडेंशियल मौजूद हैं. हालांकि, थंबनेल के यूआरएल चालू करने के लिए, आपको एपीआई पासकोड और वेब ऐप्लिकेशन क्रेडेंशियल बनाने होंगे. साथ ही, ऐक्सेस टोकन पाने के लिए, वेब ऐप्लिकेशन क्रेडेंशियल का इस्तेमाल करना होगा. आखिर में, इन क्रेडेंशियल का इस्तेमाल करके, खोज के लिए इस्तेमाल होने वाला ऐप्लिकेशन पाया और अपडेट किया जाता है.

  1. अगर आपने अब तक अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट नहीं बनाया है, तो कोई प्रोजेक्ट बनाएं या कोई मौजूदा प्रोजेक्ट चुनें और एपीआई को चालू करें. इन दो चरणों के बारे में जानने के लिए, Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करना लेख में पहला और दूसरा चरण देखें.
  2. एपीआई पासकोड बनाएं:
    1. Cloud Console में, क्रेडेंशियल बनाएं ड्रॉप-डाउन सूची पर क्लिक करें और एपीआई पासकोड चुनें. "एपीआई पासकोड बनाया गया" पेज दिखेगा.
    2. एपीआई पासकोड नोट करें.
    3. बंद करें पर क्लिक करें. नया क्रेडेंशियल, "एपीआई कुंजियां" में दिखता है.
  3. वेब ऐप्लिकेशन के क्रेडेंशियल बनाएं. रीडायरेक्ट यूआरआई के तौर पर, https://developers.google.com/oauthplayground का इस्तेमाल करें. . ये क्रेडेंशियल बनाने का तरीका जानने के लिए, वेब ऐप्लिकेशन क्रेडेंशियल (क्लाइंट-साइड JavaScript) बनाना लेख पढ़ें.
  4. OAuth 2.0 प्लैटफ़ॉर्म में, OAuth 2.0 कॉन्फ़िगरेशन पर क्लिक करें.
  5. अपने क्रेडेंशियल इस्तेमाल करें पर सही का निशान लगाएं.
  6. तीसरे चरण में जनरेट किया गया क्लाइंट आईडी और क्लाइंट सीक्रेट डालें.
  7. दायरों वाले फ़ील्ड में, https://www.googleapis.com/auth/cloud_search.settings लिखें और एपीआई को अनुमति दें पर क्लिक करें.
  8. (ज़रूरी नहीं) अगर आपको साइन इन करने की स्क्रीन दिखती है, तो इस्तेमाल करने के लिए कोई खाता चुनें.
  9. (ज़रूरी नहीं) अगर आपको अनुमति देने के लिए कोई स्क्रीन दिखती है, तो स्वीकार करें पर क्लिक करें.
  10. टोकन के लिए ऑथराइज़ेशन कोड बदलें पर क्लिक करें. एक टोकन दिखाया जाता है.
  11. उस सर्च ऐप्लिकेशन की पहचान करें जिसके लिए आपको थंबनेल कंट्रोल की सुविधा चालू करनी है.

  12. खोज ऐप्लिकेशन का आईडी पाने के लिए, settings.searchapplications.get पर कॉल करें:

    curl \ 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/search_application_id?key=[YOUR_API_KEY]' \
 --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
 --header 'Accept: application/json' \
 --compressed

    कहां:

    • , उस सर्च ऐप्लिकेशन का आईडी है जिसे वापस लाना है.
    • YOUR_API_KEY आपके प्रोजेक्ट का एपीआई पासकोड है. इसे दूसरे चरण में पाया जाता है.
    • YOUR_ACCESS_TOKEN आपके प्रोजेक्ट के लिए OAuth 2.0 ऐक्सेस टोकन है. इसे 10वें चरण से हासिल किया जाता है.

    इस निर्देश का नतीजा कुछ ऐसा दिखता है:

    {
 "name": "searchapplications/search_application_id",
 "displayName": "SearchApp_Display_Name",
 "dataSourceRestrictions": [
   {
     "source": {
       "name": "datasources/datasource_id"
     }
   }
 ]
}

  13. खोज ऐप्लिकेशन के लिए थंबनेल यूआरएल चालू करने के लिए, returnResultThumbnailUrls को true पर सेट करके setting.searchapplications.update को कॉल करें:

    curl --request PUT \  'https://cloudsearch.googleapis.com/v1/settings/searchapplications/search_application_id?key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"name":"searchapplications/search_application_id","displayName":"SearchApp_Display_Name","dataSourceRestrictions":[{"source":
    {"name":"datasources/datasource_id"}}],"returnResultThumbnailUrls":true}' \
  --compressed

    कहां:

    • , उस सर्च ऐप्लिकेशन का आईडी है जिसे वापस लाना है.
    • YOUR_API_KEY आपके प्रोजेक्ट का एपीआई पासकोड है. इसे दूसरे चरण में पाया जाता है.
    • YOUR_ACCESS_TOKEN आपके प्रोजेक्ट के लिए OAuth 2.0 ऐक्सेस टोकन है. इसे 10वें चरण से हासिल किया जाता है.
    • SearchApp_DisplayName, पिछले cURL कमांड से मिला डिसप्ले नेम है.
    • "returnResultThumbnailUrls":true, थंबनेल की सुविधा चालू करता है.

    इस निर्देश का नतीजा कुछ ऐसा दिखता है:

    {
  "name": "searchapplications/search_application_id",
  "displayName": "SearchApp_Display_Name",
  "dataSourceRestrictions": [
    {
      "source": {
        "name": "datasources/datasource_id"
      }
    }
  ],
  "returnResultThumbnailUrls": true
}

थंबनेल ऐक्सेस करना

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