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

تظهر الصور المصغّرة للمستندات التي تعرضها نتائج البحث. تتيح الصور المصغّرة للمستخدم تحديد مدى صلة المستندات المعروضة بطلبه بشكل أفضل. تتضمّن الصور المصغّرة الخصائص التالية:

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

يتم إنشاء الصور المصغّرة تلقائيًا لملفات Google Drive التي تتوافق بشكل طبيعي مع الصور المصغّرة، مثل أنواع مستندات Google Workspace ("مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" وما إلى ذلك). بالإضافة إلى ذلك، تنشئ خدمة Cloud Search تلقائيًا صورًا مصغّرة لأنواع الملفات التالية:

• ‫Microsoft Word (ملف DOC)
• ‫Microsoft Word (ملف DOCX)
• Microsoft Excel (ملف XLS)
• ‫Microsoft Excel (ملف XLSX)
• ‫Microsoft Powerpoint (ملف PPT)
• ‫Microsoft Powerpoint (ملف PPTX)
• Adobe Portable Document Format (PDF)
• تنسيق النصوص المنسّقة (RTF)
• تنسيق النص (TXT)
• لغة ترميز النص الفائق (HTML)
• لغة الترميز القابلة للامتداد (XML)

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

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

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

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

    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 هو مفتاح واجهة برمجة التطبيقات لمشروعك (تم الحصول عليه من الخطوة 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 على بيانات اعتماد حساب الخدمة. ومع ذلك، لتفعيل عناوين URL الخاصة بالصور المصغّرة، يجب إنشاء مفتاح API وبيانات اعتماد تطبيق الويب واستخدام بيانات اعتماد تطبيق الويب للحصول على رمز دخول. أخيرًا، يمكنك استخدام بيانات الاعتماد هذه للحصول على تطبيق بحث وتعديله.

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

    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 هو مفتاح واجهة برمجة التطبيقات لمشروعك (تم الحصول عليه من الخطوة 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.