Method: media.upload

تحمِّل الوسائط لفهرستها.

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

  1. يمكنك استدعاء indexing.datasources.items.upload مع ذكر اسم العنصر لبدء جلسة تحميل واسترداد UploadItemRef.
  2. يمكنك استدعاء media.upload لتحميل المحتوى، كطلب بث، باستخدام اسم المورد نفسه من UploadItemReview من الخطوة 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

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