تفعيل الصور المصغّرة

تساعد الصور المصغّرة المستخدمين في تحديد نتائج البحث ذات الصلة. وتتّسم هذه الصور بالخصائص التالية:

• عرض 1024 بكسل
• عناوين URL للصور المصغّرة لملفات Google Workspace محمية بقوائم التحكّم بالوصول (ACL) ولا ينطبق ذلك على أنواع الملفات الأخرى.
• تنتهي صلاحية عناوين URL بعد 5 دقائق.
• الحد الأقصى لحجم الملف الذي يمكن إنشاء صورة مصغّرة له هو 50 ميغابايت.
• إذا تعذّر إنشاء الصورة المصغّرة، يعرض Cloud Search رمزًا نائبًا. بالنسبة إلى عناصر Google Workspace، يعرض عنوان URL الخطأ "404 Not Found". ويجب أن يتعامل تطبيقك مع هذا الخطأ.

ينشئ Google Drive تلقائيًا صورًا مصغّرة للأنواع المتوافقة، مثل "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google". ينشئ Cloud Search أيضًا صورًا مصغّرة لما يلي:

• Microsoft Word (DOC وDOCX)
• Microsoft Excel (XLS وXLSX)
• Microsoft PowerPoint (PPT وPPTX)
• Adobe PDF
• RTF وTXT وHTML وXML

لا يعرض Cloud Search الصور المصغّرة للعناصر إلا عند تفعيل الصور المصغّرة لمصدر البيانات وتطبيق البحث.

تفعيل عناوين URL للصور المصغّرة لمصدر بيانات

لتفعيل عناوين URL للصور المصغّرة، عليك إنشاء مفتاح واجهة برمجة التطبيقات وبيانات اعتماد تطبيق الويب. استخدِم هذه البيانات للحصول على رمز دخول لتعديل مصدر البيانات.

1. أنشئ مشروعًا أو اختَره وفعِّل واجهة برمجة التطبيقات. يمكنك الاطّلاع على مقالة ضبط إذن الوصول إلى Cloud Search API.
2. أنشئ مفتاح واجهة برمجة التطبيقات في Google Cloud Console واحتفظ بالقيمة.
3. أنشئ بيانات اعتماد تطبيق الويب. استخدِم https://developers.google.com/oauthplayground كمعرّف موارد منتظم (URI) لإعادة التوجيه. يمكنك الاطّلاع على مقالة إنشاء بيانات اعتماد.
4. في مساحة بروتوكول OAuth 2.0، افتح إعدادات إعداد OAuth 2.0 .
5. اختَر استخدام بيانات الاعتماد الخاصة بك وأدخِل معرّف العميل والسر.
6. أدخِل https://www.googleapis.com/auth/cloud_search.settings في حقل النطاقات وانقر على تفويض واجهات برمجة التطبيقات.
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. احصل على مفتاح واجهة برمجة التطبيقات ورمز الدخول باستخدام الطريقة نفسها الموضّحة في القسم السابق.

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
   

الوصول إلى الصور المصغّرة

للوصول إلى صورة مصغّرة لملف في Drive، يجب أن يستخدم المستخدم أو التطبيق بيانات الاعتماد نفسها المستخدَمة للوصول إلى العنصر الأصلي.