Method: references.insert

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

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

طلب HTTP

  • عنوان URI للتحميل، لطلبات تحميل الوسائط:
    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.