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

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

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

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

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

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

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