Method: references.insert

ينشئ مرجعًا بإحدى الطرق التالية:

  • إذا كان طلبك يحمّل ملفًا مرجعيًا، تنشئ منصة YouTube المرجع من المحتوى المقدّم. يمكنك تقديم ملف فيديو/صوت أو بصمة إصبع تم إنشاؤها مسبقًا. إذا كنت توفّر ملفًا مرجعيًا تم إنشاؤه مسبقًا، اضبط السمة fpDirect للمورد reference على true في نص الطلب. في هذه العملية، يمكنك استخدام خطوات التحميل المتعدد الأجزاء أو resumable لتقديم محتوى المرجع.
  • إذا أردت إنشاء مرجع باستخدام فيديو تمّت المطالبة بملكيته باعتباره محتوًى مرجعيًا، استخدِم المَعلمة 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.