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

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

• العرض 1024 بكسل
• إنّ عناوين URL الخاصة بالصور المصغّرة لملفات Google Workspace محمية بقوائم التحكم بالوصول. ولا يمكن استخدام أنواع الملفات الأخرى.
• تنتهي صلاحية عناوين 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 الخاصة بالصور المصغّرة، أنشئ مفتاح API وبيانات اعتماد لتطبيق ويب. استخدِم هذه المعرّفات للحصول على رمز مميّز للوصول من أجل تعديل مصدر البيانات.

1. أنشئ مشروعًا أو اختَر مشروعًا وفعِّل واجهة برمجة التطبيقات. يمكنك الاطّلاع على ضبط أذونات الوصول إلى Cloud Search API.
2. أنشئ مفتاح واجهة برمجة تطبيقات في وحدة تحكّم Google Cloud واحتفظ بالقيمة.
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، يجب أن يستخدم المستخدم أو التطبيق بيانات الاعتماد نفسها المستخدَمة للوصول إلى العنصر الأصلي.