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

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

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

يتم إنشاء الصور المصغرة تلقائيًا لملفات Google Drive التي إتاحة الصور المصغّرة، مثل أنواع مستندات Google Workspace ("مستندات 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
2. إنشاء مفتاح واجهة برمجة التطبيقات:
   1. في وحدة تحكم Google Cloud، انقر فوق القائمة المنسدلة "Create Credentials" (إنشاء بيانات اعتماد) وحدد مفتاح واجهة برمجة التطبيقات. "تم إنشاء مفتاح واجهة برمجة التطبيقات" صفحة تسجيل الدخول.
   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 للرموز المميّزة. يتم إرجاع رمز مميّز.
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 للصور المصغّرة للبيانات. :source

    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
2. إنشاء مفتاح واجهة برمجة التطبيقات:
   1. في Cloud Console، انقر فوق القائمة المنسدلة "Create Credentials" (إنشاء بيانات اعتماد) وحدد مفتاح واجهة برمجة التطبيقات. "تم إنشاء مفتاح واجهة برمجة التطبيقات" صفحة تسجيل الدخول.
   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 للرموز المميّزة. يتم إرجاع رمز مميّز.
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.