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

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

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

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

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

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

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.