Method: references.insert

إنشاء مرجع بإحدى الطريقتَين التاليتَين:

  • إذا كان طلبك يتضمّن تحميل ملف مرجعي، تنشئ منصة YouTube المرجع من المحتوى المقدَّم. يمكنك تقديم ملف فيديو أو صوت أو بصمة تم إنشاؤها مسبقًا. إذا كنت تقدّم بصمة تم إنشاؤها مسبقًا، اضبط سمة fpDirect لمورد reference على true في نص الطلب. في هذه العملية، يمكنك استخدام عملية تحميل متعدّدة الأجزاء أو عملية تحميل قابلة للاستئناف لتوفير المحتوى المرجعي.
  • إذا كنت تريد إنشاء مرجع باستخدام فيديو تمّت المطالبة بملكيته كمحتوى مرجعي، استخدِم المَعلمة claimId لتحديد المطالبة.

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية، للطلبات المتعلّقة بالبيانات الوصفية فقط:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

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

مَعلمات طلب البحث

المعلمات
claimId

string

تحدِّد المَعلمة claimId معرّف المطالبة على YouTube لمطالبة حالية يجب إنشاء مرجع منها. (يُستخدَم الفيديو الذي تمّت المطالبة بملكيته كمحتوى مرجعي).
onBehalfOfContentOwner

string

تحدِّد المَعلمة onBehalfOfContentOwner مالك المحتوى الذي يتصرّف المستخدم نيابةً عنه. تتيح هذه المَعلمة للمستخدمين الذين تم ربط حساباتهم بالعديد من مالكي المحتوى.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Reference.

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/youtubepartner

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.