اقدام از طرف مالک محتوا

هر شیء در سیستم مدیریت حقوق YouTube با مالک محتوا مرتبط است. صاحب محتوا شریک YouTube است که حقوق مجموعه‌ای از دارایی‌ها را دارد. وقتی برنامه‌ای از API شناسه محتوای YouTube استفاده می‌کند، باید از مالک محتوا برای دارایی‌ها، خط‌مشی‌ها و ادعاهایی که ایجاد یا دستکاری می‌کند مجوز داشته باشد. زمانی که کاربر احراز هویت شده برنامه به حساب مالک محتوا دسترسی داشته باشد، این مجوز را دریافت می کند. اگر کاربر احراز هویت شده به حساب مالک محتوا دسترسی نداشته باشد ، تماس با Content ID API ناموفق است.

شناسه مالک محتوا را بازیابی کنید

برای بازیابی شناسه مالک محتوا، با روش contentOwners.list API شناسه محتوای YouTube تماس بگیرید. پاسخ API حاوی لیستی از منابع contentOwner مرتبط با کاربری است که درخواست را مجاز کرده است. در هر منبع، ویژگی id شناسه مالک محتوا را مشخص می کند.

برای مثالی که شناسه مالک محتوا را به صورت برنامه‌نویسی بازیابی می‌کند، به آپلود و ادعای یک ویدیو مراجعه کنید.

از طرف مالک محتوا با APIهای YouTube تماس بگیرید

API شناسه محتوای YouTube

از آنجایی که اکثر کاربران به یک حساب مالک محتوا دسترسی دارند، Content ID API می تواند به طور ضمنی مالک محتوا را که کاربر به عنوان آن عمل می کند، تعیین کند. به این ترتیب، پارامتر onBehalfOfContentOwner برای تماس‌های Content ID API اختیاری است.

با این حال، برخی از کاربران به چندین حساب مالک محتوا دسترسی دارند. برای این کاربران، هر درخواست API باید شامل پارامتر onBehalfOfContentOwner باشد تا مشخصاً از کدام حساب مالک محتوا استفاده شود.

YouTube Data API (نسخه 3)

بسیاری از روش‌های YouTube Data API از پارامتر onBehalfOfContentOwner نیز پشتیبانی می‌کنند. روش‌هایی که از آن پارامتر استفاده می‌کنند از تفویض اختیار استفاده می‌کنند و به برنامه اجازه می‌دهند تا اقداماتی را در کانال‌های مدیریت شده توسط مالک محتوا، روی ویدیوهای موجود در آن کانال‌های مدیریت‌شده یا سایر منابع API انجام دهد.

هنگام استفاده از تفویض اختیار در YouTube Data API، پارامتر onBehalfOfContentOwner همیشه مورد نیاز است. مقدار پارامتر یک شناسه است که به طور منحصر به فرد مالک محتوا را شناسایی می کند. می‌توانید با فراخوانی روش contentOwners.list API شناسه محتوای YouTube، شناسه را به‌صورت برنامه‌نویسی بازیابی کنید.

برخی از تماس‌های API به یک پارامتر تفویض اختیار اضافی نیز نیاز دارند. لیست زیر دو نمونه را توضیح می دهد:

• متد videos.insert() نیاز به تنظیم پارامترهای onBehalfOfContentOwner و onBehalfOfContentOwnerChannel دارد که کاربر در حال انجام عملی در کانال به عنوان مالک محتوا است. ویدیوی جدید در کانالی که مقدار پارامتر onBehalfOfContentOwnerChannel آن را مشخص می کند آپلود می شود.
• متد search.list() نیاز به تنظیم پارامترهای onBehalfOfContentOwner و forContentOwner دارد. در این مورد، پارامتر forContentOwner به کاربر اجازه می‌دهد به API دستور دهد که فقط منابع متعلق به مالک محتوا را که پارامتر onBehalfOfContentOwner مشخص می‌کند، برگرداند.

اسناد مربوط به هر روش خاص، جزئیات مربوط به زمانی که از تفویض اختیار پشتیبانی می‌کند و اینکه آیا شما نیاز به تنظیم یک پارامتر اضافی به غیر از onBehalfOfContentOwner دارید یا خیر.

YouTube Analytics API

برای بازیابی گزارش مالک محتوا با استفاده از YouTube Analytics API، مقدار پارامتر ids در درخواست API خود روی contentOwner==OWNER_ID تنظیم می‌کنید، جایی که OWNER_ID شناسه مالک محتوا را مشخص می‌کند.