Method: references.insert

یک مرجع را به یکی از روش‌های زیر ایجاد می‌کند:

  • اگر درخواست شما آپلود یک فایل مرجع باشد، یوتیوب مرجع را از محتوای ارائه شده ایجاد می‌کند. می‌توانید یک فایل ویدیویی/صوتی یا یک اثر انگشت از پیش تولید شده ارائه دهید. اگر یک اثر انگشت از پیش تولید شده ارائه می‌دهید، ویژگی fpDirect منبع reference را در بدنه درخواست روی true تنظیم کنید. در این جریان، می‌توانید از جریان‌های آپلود چندبخشی یا از سرگیری برای ارائه محتوای مرجع استفاده کنید.
  • اگر می‌خواهید با استفاده از یک ویدیوی ادعا شده به عنوان محتوای مرجع، یک مرجع ایجاد کنید، از پارامتر claimId برای شناسایی ادعا استفاده کنید.

درخواست HTTP

  • آپلود URI، برای درخواست‌های آپلود رسانه:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • آدرس URL فراداده، برای درخواست‌های فقط فراداده:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
claimId

string

پارامتر claimId شناسه ادعای یوتیوب یک ادعای موجود را مشخص می‌کند که باید از آن یک مرجع ایجاد شود. (ویدیوی ادعا شده به عنوان محتوای مرجع استفاده می‌شود.)

onBehalfOfContentOwner

string

پارامتر onBehalfOfContentOwner مالک محتوایی را که کاربر از طرف او عمل می‌کند، شناسایی می‌کند. این پارامتر از کاربرانی پشتیبانی می‌کند که حساب‌های کاربری آنها با چندین مالک محتوا مرتبط است.

درخواست بدنه

بدنه درخواست شامل یک نمونه از Reference است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Reference است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .