Method: media.upload

تحميل الوسائط للفهرسة

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

  1. يُرجى الاتصال برقم indexing.datasources.items.upload وإبلاغه باسم العنصر لبدء جلسة تحميل واسترداد UploadItemRef.
  2. استخدِم media.upload لتحميل المحتوى كطلب بث باستخدام اسم المورد نفسه من UploadItemRef من الخطوة 1.
  3. يُرجى الاتصال برقم indexing.datasources.items.index لفهرسة العنصر. املأ ItemContent باستخدام UploadItemRef من الخطوة 1.

لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء موصِّل محتوى باستخدام واجهة برمجة التطبيقات REST API.

ملاحظة: تتطلّب واجهة برمجة التطبيقات هذه حساب خدمة لتنفيذها.

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية، للطلبات المتعلّقة بالبيانات الوصفية فقط:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
resourceName

string

اسم الوسائط التي يتم تنزيلها يمكنك الاطّلاع على ReadRequest.resource_name.

نص الطلب

يحتوي نص الطلب على مثال Media.

نص الاستجابة

مرجع الوسائط

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

اسم مصدر الوسائط

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.