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

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

• 1024 पिक्सल की चौड़ाई.
• Google Workspace की फ़ाइल के थंबनेल का यूआरएल, ACL से सुरक्षित है. इसके लिए URL अन्य फ़ाइल प्रकार ACL-सुरक्षित नहीं हैं
• यूआरएल की समयसीमा पांच मिनट बाद खत्म हो जाती है.
• थंबनेल 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)
• हाइपरटेक्स्ट मार्कअप लैंग्वेज (HTML)
• एक्सटेंसिबल मार्कअप लैंग्वेज (एक्सएमएल)

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

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

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

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

    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 डिस्क में आइटम.