ریز عکسها را فعال کنید

تصاویر کوچک برای اسنادی که توسط نتایج جستجو برگردانده می‌شوند، نشان داده می‌شوند. تصاویر کوچک به کاربر اجازه می‌دهند تا ارتباط اسناد برگردانده شده را بهتر تشخیص دهد. تصاویر کوچک دارای ویژگی‌های زیر هستند:

• عرض ۱۰۲۴ پیکسل.
• نشانی اینترنتی (URL) مربوط به تصاویر کوچک فایل‌های Google Workspace دارای حفاظت ACL است. نشانی اینترنتی سایر انواع فایل‌ها دارای حفاظت ACL نیست.
• آدرس‌های اینترنتی (URL) پس از ۵ دقیقه منقضی می‌شوند.
• تصاویر کوچک برای فایل‌های بزرگتر از ۵۰ مگابایت ایجاد نمی‌شوند.
• اگر امکان ایجاد تصویر بندانگشتی وجود نداشته باشد، از یک آیکون placeholder استفاده می‌شود. اگر امکان ایجاد تصویر بندانگشتی برای یک آیتم Google Workspace وجود نداشته باشد، URL تصویر بندانگشتی خطای "404 یافت نشد" را برمی‌گرداند. برنامه شما باید این رفتار را مدیریت کند.

تصاویر بندانگشتی به‌طور خودکار برای فایل‌های گوگل درایو که به‌طور طبیعی از تصاویر بندانگشتی پشتیبانی می‌کنند، مانند انواع سندهای Google Workspace (Docs، Sheets، Slides و غیره) ایجاد می‌شوند. علاوه بر این، Cloud Search به‌طور خودکار برای انواع فایل‌های زیر تصاویر بندانگشتی ایجاد می‌کند:

• مایکروسافت ورد (DOC)
• مایکروسافت ورد (DOCX)
• مایکروسافت اکسل (XLS)
• مایکروسافت اکسل (XLSX)
• مایکروسافت پاورپوینت (PPT)
• مایکروسافت پاورپوینت (PPTX)
• قالب سند قابل حمل ادوبی (PDF)
• قالب متن غنی (RTF)
• قالب متن (TXT)
• زبان نشانه‌گذاری فرامتن (HTML)
• زبان نشانه‌گذاری توسعه‌پذیر (XML)

تصاویر کوچک فقط برای مواردی که منبع داده و برنامه‌های جستجو آنها را فعال کرده‌اند، بازگردانده می‌شوند.

فعال کردن URL های تصویر بندانگشتی برای یک منبع داده

پروژه پلتفرم جستجوی ابری شما شامل اعتبارنامه‌های حساب کاربری سرویس است. با این حال، برای فعال کردن URLهای تصویر بندانگشتی، باید یک کلید API و اعتبارنامه‌های برنامه وب ایجاد کنید و از اعتبارنامه‌های برنامه وب برای دریافت یک توکن دسترسی استفاده کنید. در نهایت، از این اعتبارنامه‌ها برای دریافت و به‌روزرسانی یک منبع داده استفاده می‌کنید.

1. اگر قبلاً این کار را نکرده‌اید، یک پروژه برای برنامه خود ایجاد یا انتخاب کنید و API را فعال کنید. برای اطلاعات در مورد این دو مرحله، به مرحله 1 و 2 پیکربندی دسترسی به API جستجوی Google Cloud مراجعه کنید.
2. یک کلید API ایجاد کنید:
   1. در کنسول گوگل کلود، روی لیست کشویی Create Credentials کلیک کنید و API Key را انتخاب کنید. صفحه "API Key created" ظاهر می‌شود.
   2. به کلید API توجه کنید.
   3. روی بستن کلیک کنید. اعتبارنامه تازه ایجاد شده در زیر «کلیدهای API» ظاهر می‌شود.
3. ایجاد اعتبارنامه‌های برنامه وب. https://developers.google.com/oauthplayground به عنوان آدرس اینترنتی تغییر مسیر استفاده کنید. برای مراحل ایجاد این اعتبارنامه‌ها، به ایجاد اعتبارنامه‌های برنامه وب (جاوااسکریپت سمت کلاینت) مراجعه کنید.
4. در محیط OAuth 2.0 Playground ، پیکربندی OAuth 2.0 کلیک کنید.
5. گزینه «از اعتبارنامه‌های خودتان استفاده کنید» را تیک بزنید.
6. شناسه کلاینت و رمز کلاینت تولید شده در مرحله ۳ را وارد کنید.
7. در فیلد scopes، عبارت https://www.googleapis.com/auth/cloud_search.settings را تایپ کنید و روی Authorize APIs کلیک کنید.
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 کلید API پروژه شماست (که از مرحله ۲ به دست آمده است).
    • YOUR_ACCESS_TOKEN توکن دسترسی OAuth 2.0 برای پروژه شماست (که از مرحله 10 بدست آمده است).

    نتیجه موفقیت‌آمیز این دستور مشابه زیر است:

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

13. برای فعال کردن URL های تصویر بندانگشتی برای منبع داده، تابع 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 کلید API پروژه شماست (که از مرحله ۲ به دست آمده است).
    • 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
      }
    }
    

فعال کردن URL های تصویر بندانگشتی برای یک برنامه جستجو

پروژه پلتفرم جستجوی ابری شما شامل اعتبارنامه‌های حساب کاربری سرویس است. با این حال، برای فعال کردن URLهای تصویر بندانگشتی، باید یک کلید API و اعتبارنامه‌های برنامه وب ایجاد کنید و از اعتبارنامه‌های برنامه وب برای دریافت یک توکن دسترسی استفاده کنید. در نهایت، از این اعتبارنامه‌ها برای دریافت و به‌روزرسانی یک برنامه جستجو استفاده می‌کنید.

1. اگر قبلاً این کار را نکرده‌اید، یک پروژه برای برنامه خود ایجاد یا انتخاب کنید و API را فعال کنید. برای اطلاعات در مورد این دو مرحله، به مرحله 1 و 2 پیکربندی دسترسی به API جستجوی Google Cloud مراجعه کنید.
2. یک کلید API ایجاد کنید:
   1. در کنسول ابری، روی فهرست کشویی «ایجاد اعتبارنامه‌ها» کلیک کنید و کلید API را انتخاب کنید. صفحه «کلید API ایجاد شد» ظاهر می‌شود.
   2. به کلید API توجه کنید.
   3. روی بستن کلیک کنید. اعتبارنامه تازه ایجاد شده در زیر «کلیدهای API» ظاهر می‌شود.
3. ایجاد اعتبارنامه‌های برنامه وب. https://developers.google.com/oauthplayground به عنوان آدرس اینترنتی تغییر مسیر استفاده کنید. برای مراحل ایجاد این اعتبارنامه‌ها، به ایجاد اعتبارنامه‌های برنامه وب (جاوااسکریپت سمت کلاینت) مراجعه کنید.
4. در محیط OAuth 2.0 Playground ، پیکربندی OAuth 2.0 کلیک کنید.
5. گزینه «از اعتبارنامه‌های خودتان استفاده کنید» را تیک بزنید.
6. شناسه کلاینت و رمز کلاینت تولید شده در مرحله ۳ را وارد کنید.
7. در فیلد scopes، عبارت https://www.googleapis.com/auth/cloud_search.settings را تایپ کنید و روی Authorize APIs کلیک کنید.
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 کلید API پروژه شماست (که از مرحله ۲ به دست آمده است).
    • YOUR_ACCESS_TOKEN توکن دسترسی OAuth 2.0 برای پروژه شماست (که از مرحله 10 بدست آمده است).

    نتیجه موفقیت‌آمیز این دستور مشابه زیر است:

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

13. برای فعال کردن URL های تصویر بندانگشتی برای برنامه جستجو، تابع 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 کلید API پروژه شماست (که از مرحله ۲ به دست آمده است).
    • 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
    }
    

دسترسی به تصاویر کوچک

برای دسترسی به تصویر بندانگشتی یک فایل Google Workspace در Drive، کاربر یا برنامه باید همان اطلاعات حساب کاربری را که برای دسترسی به آن مورد در Google Drive استفاده می‌کند، وارد کند.