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

  • معرّف الموارد المنتظم (URI) للتحميل، لطلبات تحميل الوسائط:
    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

لمزيد من المعلومات، راجِع دليل التفويض.