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

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

• عرض 1024 پیکسل
• URL برای تصاویر کوچک فایل Google Workspace با ACL محافظت می شود. نشانی وب سایر انواع فایل با ACL محافظت نمی شود
• URL ها بعد از 5 دقیقه منقضی می شوند.
• تصاویر کوچک برای فایل های بزرگتر از 50 مگابایت ایجاد نمی شوند.
• اگر تصویر کوچکی تولید نمی‌شود، از نماد مکان‌نما استفاده می‌شود. اگر تصویر کوچکی برای یک مورد Google Workspace ایجاد نشود، URL تصویر کوچک «404 یافت نشد» را برمی‌گرداند. برنامه شما باید این رفتار را مدیریت کند.

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

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

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

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

پروژه پلتفرم Cloud Search شما حاوی اطلاعات کاربری حساب سرویس است. با این حال، برای فعال کردن نشانی‌های اینترنتی تصویر کوچک، باید یک کلید API و اعتبار برنامه‌های وب ایجاد کنید و از اعتبارنامه‌های برنامه وب برای به دست آوردن نشانه دسترسی استفاده کنید. در نهایت، شما از این اعتبارنامه ها برای دریافت و به روز رسانی یک منبع داده استفاده می کنید.

1. اگر قبلاً این کار را نکرده‌اید، یک پروژه برای برنامه خود ایجاد یا انتخاب کنید و API را فعال کنید. برای اطلاع از این دو مرحله، به مرحله 1 و 2 پیکربندی دسترسی به Google Cloud Search API مراجعه کنید.
2. یک کلید API ایجاد کنید:
   1. در کنسول Google Cloud، روی لیست کشویی Creed Credentials کلیک کنید و API Key را انتخاب کنید. صفحه "کلید API ایجاد شد" ظاهر می شود.
   2. به کلید API توجه کنید.
   3. روی Close کلیک کنید. اعتبار جدید ایجاد شده در زیر "کلیدهای API" ظاهر می شود.
3. اعتبار برنامه کاربردی وب را ایجاد کنید. از https://developers.google.com/oauthplayground به عنوان URI تغییر مسیر استفاده کنید. . برای مراحل ایجاد این اعتبارنامه ها، به ایجاد اعتبارنامه برنامه کاربردی وب (جاوا اسکریپت سمت سرویس گیرنده) مراجعه کنید.
4. در OAuth 2.0 Playground ، روی پیکربندی OAuth 2.0 کلیک کنید.
5. تیک Use your own credentials را بزنید.
6. شناسه مشتری و راز مشتری ایجاد شده در مرحله 3 را وارد کنید.
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 پروژه شما است (به دست آمده از مرحله 2).
    • 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 کلید API پروژه شما است (به دست آمده از مرحله 2).
    • 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 های تصویر کوچک را برای یک برنامه جستجو فعال کنید

پروژه پلتفرم Cloud Search شما حاوی اطلاعات کاربری حساب سرویس است. با این حال، برای فعال کردن نشانی‌های اینترنتی تصویر کوچک، باید یک کلید API و اعتبار برنامه‌های وب ایجاد کنید و از اعتبارنامه‌های برنامه وب برای به دست آوردن نشانه دسترسی استفاده کنید. در نهایت، شما از این اعتبارنامه ها برای دریافت و به روز رسانی یک برنامه جستجو استفاده می کنید.

1. اگر قبلاً این کار را نکرده‌اید، یک پروژه برای برنامه خود ایجاد یا انتخاب کنید و API را فعال کنید. برای اطلاع از این دو مرحله، به مرحله 1 و 2 پیکربندی دسترسی به Google Cloud Search API مراجعه کنید.
2. یک کلید API ایجاد کنید:
   1. در کنسول ابری، روی فهرست کشویی Creed Credentials کلیک کرده و API Key را انتخاب کنید. صفحه "کلید API ایجاد شد" ظاهر می شود.
   2. به کلید API توجه کنید.
   3. روی Close کلیک کنید. اعتبار جدید ایجاد شده در زیر "کلیدهای API" ظاهر می شود.
3. اعتبار برنامه کاربردی وب را ایجاد کنید. از https://developers.google.com/oauthplayground به عنوان URI تغییر مسیر استفاده کنید. . برای مراحل ایجاد این اعتبارنامه ها، به ایجاد اعتبارنامه برنامه کاربردی وب (جاوا اسکریپت سمت سرویس گیرنده) مراجعه کنید.
4. در OAuth 2.0 Playground ، روی پیکربندی OAuth 2.0 کلیک کنید.
5. تیک Use your own credentials را بزنید.
6. شناسه مشتری و راز مشتری ایجاد شده در مرحله 3 را وارد کنید.
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 پروژه شما است (به دست آمده از مرحله 2).
    • 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 کلید API پروژه شما است (به دست آمده از مرحله 2).
    • 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 استفاده می‌کند، ارسال کند.