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

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

  • चौड़ाई 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)
  • रिच टेक्स्ट फ़ॉर्मैट (आरटीएफ़)
  • टेक्स्ट फ़ॉर्मैट (TXT)
  • हाइपरटेक्स्ट मार्कअप लैंग्वेज (एचटीएमएल)
  • एक्सटेंसिबल मार्कअप लैंग्वेज (एक्सएमएल)

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

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

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

  1. अगर आपने अब तक अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट नहीं बनाया है, तो उसे बनाएं या कोई प्रोजेक्ट चुनें. इसके बाद, एपीआई चालू करें. इन दो चरणों के बारे में जानने के लिए, Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करना लेख में दिए गए पहले और दूसरे चरण को पढ़ें.
  2. एपीआई पासकोड बनाएं:
    1. Google Cloud Console में, क्रेडेंशियल बनाएं ड्रॉप-डाउन सूची पर क्लिक करें और एपीआई पासकोड चुनें. "एपीआई कुंजी बनाई गई" पेज दिखता है.
    2. एपीआई पासकोड को नोट करें.
    3. बंद करें पर क्लिक करें. नया क्रेडेंशियल, "एपीआई पासकोड" में दिखता है.
  3. वेब ऐप्लिकेशन क्रेडेंशियल बनाएं. रीडायरेक्ट यूआरआई के तौर पर, https://developers.google.com/oauthplayground का इस्तेमाल करें. . इन क्रेडेंशियल को बनाने का तरीका जानने के लिए, वेब ऐप्लिकेशन के क्रेडेंशियल (क्लाइंट-साइड JavaScript) बनाना लेख पढ़ें.
  4. OAuth 2.0 Playground में, 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. डेटा सोर्स के लिए थंबनेल यूआरएल चालू करने के लिए, setting.datasource.update को कॉल करें. साथ ही, returnThumbnailUrls को true पर सेट करें:

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

  1. अगर आपने अब तक अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट नहीं बनाया है, तो उसे बनाएं या कोई प्रोजेक्ट चुनें. इसके बाद, एपीआई चालू करें. इन दो चरणों के बारे में जानने के लिए, Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करना लेख में दिए गए पहले और दूसरे चरण को पढ़ें.
  2. एपीआई पासकोड बनाएं:
    1. Cloud Console में, क्रेडेंशियल बनाएं ड्रॉप-डाउन सूची पर क्लिक करें और एपीआई पासकोड चुनें. "एपीआई कुंजी बनाई गई" पेज दिखता है.
    2. एपीआई पासकोड को नोट करें.
    3. बंद करें पर क्लिक करें. नया क्रेडेंशियल, "एपीआई पासकोड" में दिखता है.
  3. वेब ऐप्लिकेशन क्रेडेंशियल बनाएं. रीडायरेक्ट यूआरआई के तौर पर, https://developers.google.com/oauthplayground का इस्तेमाल करें. . इन क्रेडेंशियल को बनाने का तरीका जानने के लिए, वेब ऐप्लिकेशन के क्रेडेंशियल (क्लाइंट-साइड JavaScript) बनाना लेख पढ़ें.
  4. OAuth 2.0 Playground में, 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 में मौजूद आइटम को ऐक्सेस करते हैं.