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

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

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

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

• مایکروسافت ورد (DOC، DOCX)
• مایکروسافت اکسل (XLS، XLSX)
• مایکروسافت پاورپوینت (PPT، PPTX)
• ادوبی پی‌دی‌اف
• RTF، TXT، HTML و XML

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

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

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

1. یک پروژه ایجاد یا انتخاب کنید و API را فعال کنید. به پیکربندی دسترسی به Cloud Search API مراجعه کنید.
2. یک کلید API در کنسول Google Cloud ایجاد کنید و مقدار آن را یادداشت کنید.
3. ایجاد اعتبارنامه‌های برنامه وب. https://developers.google.com/oauthplayground به عنوان آدرس اینترنتی تغییر مسیر استفاده کنید. به بخش ایجاد اعتبارنامه‌ها مراجعه کنید.
4. در محیط OAuth 2.0 Playground ، پیکربندی OAuth 2.0 را باز کنید.
5. گزینه «استفاده از اعتبارنامه‌های خودتان» را انتخاب کنید و شناسه کلاینت و رمز عبور خود را وارد کنید.
6. در فیلد scopes، آدرس https://www.googleapis.com/auth/cloud_search.settings را وارد کنید و روی Authorize APIs کلیک کنید.
7. کد مجوز را با توکن‌ها عوض کنید.

8. برای دریافت شناسه منبع داده خود، 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
   

9. فراخوانی settings.datasources.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":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

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

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

1. با استفاده از همان روشی که در بخش قبل توضیح داده شد، یک کلید API و توکن دسترسی دریافت کنید.

2. برای دریافت شناسه برنامه خود settings.searchapplications.get را فراخوانی کنید:

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

3. فراخوانی settings.searchapplications.update با returnResultThumbnailUrls که روی true تنظیم شده است:

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

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

برای دسترسی به تصویر بندانگشتی یک فایل درایو، کاربر یا برنامه باید از همان اعتبارنامه حساب کاربری که برای دسترسی به مورد اصلی استفاده شده است، استفاده کند.