YouTube Content ID API

API شناسه محتوای یوتیوب امکان مدیریت دارایی‌های یوتیوب به همراه محتوای مرتبط، منابع، مالکیت، حقوق و سیاست‌های آنها را فراهم می‌کند.

سرویس: youtubepartner.googleapis.com

برای فراخوانی این سرویس، توصیه می‌کنیم از کتابخانه‌های کلاینت ارائه شده توسط گوگل استفاده کنید. اگر برنامه شما برای فراخوانی این سرویس نیاز به استفاده از کتابخانه‌های خودتان دارد، هنگام ارسال درخواست‌های API از اطلاعات زیر استفاده کنید.

سند کشف

یک سند کشف ، مشخصاتی قابل خواندن توسط ماشین برای توصیف و استفاده از APIهای REST است. از آن برای ساخت کتابخانه‌های کلاینت، افزونه‌های IDE و سایر ابزارهایی که با APIهای گوگل تعامل دارند، استفاده می‌شود. یک سرویس ممکن است چندین سند کشف ارائه دهد. این سرویس سند کشف زیر را ارائه می‌دهد:

نقطه پایانی سرویس

یک نقطه پایانی سرویس ، یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و تمام URI های زیر نسبت به این نقطه پایانی سرویس هستند:

  • https://youtubepartner.googleapis.com

منبع REST: برچسب‌های دارایی

روش‌ها
insert POST /youtube/partner/v1/assetLabels
یک برچسب دارایی برای مالک درج کنید.
list GET /youtube/partner/v1/assetLabels
فهرستی از تمام برچسب‌های دارایی برای یک مالک را بازیابی می‌کند.

منبع REST: assetMatchPolicy

روش‌ها
get GET /youtube/partner/v1/assets/{assetId}/matchPolicy
سیاست تطبیق اختصاص داده شده به دارایی مشخص شده توسط مالک محتوای مرتبط با کاربر احراز هویت شده را بازیابی می‌کند.
patch PATCH /youtube/partner/v1/assets/{assetId}/matchPolicy
سیاست تطبیق دارایی را اصلاح می‌کند.
update PUT /youtube/partner/v1/assets/{assetId}/matchPolicy
سیاست تطبیق دارایی را به‌روزرسانی می‌کند.

منبع REST: assetRelationships

روش‌ها
delete DELETE /youtube/partner/v1/assetRelationships/{assetRelationshipId}
رابطه بین دو دارایی را حذف می‌کند.
insert POST /youtube/partner/v1/assetRelationships
رابطه‌ای ایجاد می‌کند که دو دارایی را به هم پیوند می‌دهد.
list GET /youtube/partner/v1/assetRelationships
فهرستی از روابط را برای یک دارایی مشخص بازیابی می‌کند.

منبع REST: assetSearch

روش‌ها
list GET /youtube/partner/v1/assetSearch
بر اساس فراداده‌های دارایی، دارایی‌ها را جستجو می‌کند.

منبع REST: assetShares

روش‌ها
list GET /youtube/partner/v1/assetShares
این روش یا فهرستی از سهام دارایی‌های متعلق به شریک را بازیابی می‌کند و آن را به یک شناسه نمای دارایی مشخص نگاشت می‌کند ، یا فهرستی از نماهای دارایی مرتبط با یک شناسه سهم دارایی مشخص متعلق به شریک را بازیابی می‌کند.

منبع REST: دارایی‌ها

روش‌ها
get GET /youtube/partner/v1/assets/{assetId}
فراداده (metadata) مربوط به دارایی مشخص شده را بازیابی می‌کند.
insert POST /youtube/partner/v1/assets
یک دارایی با فراداده مشخص شده درج می‌کند.
list GET /youtube/partner/v1/assets
لیستی از دارایی‌ها را بر اساس فراداده دارایی بازیابی می‌کند.
patch PATCH /youtube/partner/v1/assets/{assetId}
متادیتای مربوط به دارایی مشخص شده را اصلاح می‌کند.
update PUT /youtube/partner/v1/assets/{assetId}
فراداده (metadata) مربوط به دارایی مشخص شده را به‌روزرسانی می‌کند.

منبع REST: کمپین‌ها

روش‌ها
delete DELETE /youtube/partner/v1/campaigns/{campaignId}
یک کمپین مشخص شده را برای یک مالک حذف می‌کند.
get GET /youtube/partner/v1/campaigns/{campaignId}
یک کمپین خاص را برای مالک بازیابی می‌کند.
insert POST /youtube/partner/v1/campaigns
با استفاده از داده‌های کمپین مشخص‌شده، یک کمپین جدید برای مالک وارد کنید.
list GET /youtube/partner/v1/campaigns
لیستی از کمپین‌های مربوط به یک مالک را بازیابی می‌کند.
patch PATCH /youtube/partner/v1/campaigns/{campaignId}
داده‌ها را برای یک کمپین خاص پچ کنید.
update PUT /youtube/partner/v1/campaigns/{campaignId}
داده‌ها را برای یک کمپین خاص به‌روزرسانی کنید.

منبع REST: claimHistory

روش‌ها
get GET /youtube/partner/v1/claimHistory/{claimId}
تاریخچه‌ی درخواست‌ها را برای یک درخواست مشخص بازیابی می‌کند.

منبع REST: claimSearch

روش‌ها
list GET /youtube/partner/v1/claimSearch
لیستی از ادعاهایی را که با معیارهای جستجو مطابقت دارند، بازیابی می‌کند.

منبع REST: ادعاها

روش‌ها
get GET /youtube/partner/v1/claims/{claimId}
یک ادعای خاص را بر اساس شناسه بازیابی می‌کند.
insert POST /youtube/partner/v1/claims
ادعا ایجاد می‌کند.
list GET /youtube/partner/v1/claims
فهرستی از ادعاهای مدیریت‌شده توسط مالک محتوا مرتبط با کاربر احراز هویت‌شده‌ی فعلی را بازیابی می‌کند.
patch PATCH /youtube/partner/v1/claims/{claimId}
با تغییر سیاست یا وضعیت خود، یک ادعای موجود را اصلاح می‌کند.
update PUT /youtube/partner/v1/claims/{claimId}
با تغییر سیاست یا وضعیت یک ادعای موجود، آن را به‌روزرسانی می‌کند.

منبع REST: contentOwners

روش‌ها
get GET /youtube/partner/v1/contentOwners/{contentOwnerId}
اطلاعات مربوط به مالک محتوای مشخص شده را بازیابی می‌کند.
list GET /youtube/partner/v1/contentOwners
فهرستی از مالکان محتوا را که با معیارهای درخواست مطابقت دارند، بازیابی می‌کند.

منبع REST: liveCuepoints

روش‌ها
insert POST /youtube/partner/v1/liveCuepoints
یک نقطه نشانه‌گذاری (cuepoint) را در پخش زنده وارد می‌کند.

منبع REST: تاریخچه فراداده

روش‌ها
list GET /youtube/partner/v1/metadataHistory
فهرستی از تمام فراداده‌های ارائه شده برای یک دارایی را بازیابی می‌کند، صرف نظر از اینکه کدام مالک محتوا داده‌ها را ارائه داده است.

منبع REST: musicChangeRequests

روش‌ها
create POST /youtube/partner/v1/music/changeRequests
یک درخواست تغییر موسیقی ایجاد می‌کند که به یک نسخه یا یک آهنگ گزارش شده است.
list GET /youtube/partner/v1/music/changeRequests
لیستی از درخواست‌های تغییر موسیقی گزارش شده به یک نسخه یا یک آهنگ را بازیابی می‌کند.

منبع REST: musicReleases

روش‌ها
list GET /youtube/partner/v1/music/releases
فهرستی از موسیقی‌های منتشر شده را بازیابی می‌کند.

منبع REST: musicTracks

روش‌ها
list GET /youtube/partner/v1/music/{parent=releases/*}/tracks
فهرستی از آهنگ‌های موسیقی را بازیابی می‌کند.

منبع REST: مالکیت

روش‌ها
get GET /youtube/partner/v1/assets/{assetId}/ownership
داده‌های مالکیت ارائه شده برای دارایی مشخص شده توسط مالک محتوای مرتبط با کاربر احراز هویت شده را بازیابی می‌کند.
patch PATCH /youtube/partner/v1/assets/{assetId}/ownership
اطلاعات مالکیت جدیدی را برای دارایی مشخص شده ارائه می‌دهد.
update PUT /youtube/partner/v1/assets/{assetId}/ownership
اطلاعات مالکیت جدیدی را برای دارایی مشخص شده ارائه می‌دهد.

منبع REST: ownershipHistory

روش‌ها
list GET /youtube/partner/v1/ownershipHistory
فهرستی از داده‌های مالکیت یک دارایی را بازیابی می‌کند، صرف نظر از اینکه کدام مالک محتوا داده‌ها را ارائه داده است.

منبع REST: بسته

روش‌ها
get GET /youtube/partner/v1/package/{packageId}
اطلاعات مربوط به بسته‌ی مشخص‌شده را بازیابی می‌کند.
insert POST /youtube/partner/v1/package
یک بسته‌ی صرفاً متادیتا درج می‌کند.

منبع REST: سیاست‌ها

روش‌ها
get GET /youtube/partner/v1/policies/{policyId}
خط‌مشی ذخیره‌شده‌ی مشخص‌شده را بازیابی می‌کند.
insert POST /youtube/partner/v1/policies
یک خط‌مشی ذخیره‌شده ایجاد می‌کند.
list GET /youtube/partner/v1/policies
فهرستی از سیاست‌های ذخیره‌شده‌ی مالک محتوا را بازیابی می‌کند.
patch PATCH /youtube/partner/v1/policies/{policyId}
خط‌مشی ذخیره‌شده‌ی مشخص‌شده را وصله می‌کند.
update PUT /youtube/partner/v1/policies/{policyId}
خط‌مشی ذخیره‌شده‌ی مشخص‌شده را به‌روزرسانی می‌کند.

منبع REST: referenceConflicts

روش‌ها
get GET /youtube/partner/v1/referenceConflicts/{referenceConflictId}
اطلاعات مربوط به تداخل مرجع مشخص شده را بازیابی می‌کند.
list GET /youtube/partner/v1/referenceConflicts
فهرستی از تعارضات مرجع حل نشده را بازیابی می‌کند.

منبع REST: مراجع

روش‌ها
get GET /youtube/partner/v1/references/{referenceId}
اطلاعات مربوط به مرجع مشخص شده را بازیابی می‌کند.
insert POST /youtube/partner/v1/references
POST /upload/youtube/partner/v1/references

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

  • اگر درخواست شما آپلود یک فایل مرجع باشد، یوتیوب مرجع را از محتوای ارائه شده ایجاد می‌کند.
list GET /youtube/partner/v1/references
فهرستی از منابع را بر اساس شناسه یا فهرست منابع برای دارایی مشخص شده بازیابی می‌کند.
patch PATCH /youtube/partner/v1/references/{referenceId}
یک مرجع را وصله می‌کند.
update PUT /youtube/partner/v1/references/{referenceId}
یک مرجع را به‌روزرسانی می‌کند.

منبع REST: spreadsheetTemplate

روش‌ها
list GET /youtube/partner/v1/spreadsheetTemplate
فهرستی از قالب‌های صفحه‌گسترده را برای مالک محتوا بازیابی می‌کند.

منبع REST: آپلودکننده

روش‌ها
list GET /youtube/partner/v1/uploader
لیستی از آپلودکنندگان را برای یک مالک محتوا بازیابی می‌کند.

منبع REST: اعتبارسنج

روش‌ها
validate POST /youtube/partner/v1/validator
اعتبارسنجی یک فایل متادیتا.
validateAsync POST /youtube/partner/v1/validatorAsync
اعتبارسنجی یک فایل متادیتا به صورت غیرهمزمان.
validateAsyncStatus POST /youtube/partner/v1/validatorAsyncStatus
وضعیت اعتبارسنجی ناهمزمان را دریافت کنید.

منبع REST: videoAdvertisingOptions

روش‌ها
get GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}
تنظیمات تبلیغات را برای ویدیوی مشخص شده بازیابی می‌کند.
getEnabledAds GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds
جزئیات مربوط به انواع تبلیغات مجاز برای یک ویدیوی آپلود شده توسط شریک یا کاربر مشخص شده را بازیابی می‌کند.
patch PATCH /youtube/partner/v1/videoAdvertisingOptions/{videoId}
تنظیمات تبلیغات را برای ویدیوی مشخص شده اصلاح می‌کند.
update PUT /youtube/partner/v1/videoAdvertisingOptions/{videoId}
تنظیمات تبلیغات را برای ویدیوی مشخص‌شده به‌روزرسانی می‌کند.

منبع REST: لیست‌های سفید

روش‌ها
delete DELETE /youtube/partner/v1/whitelists/{id}
یک کانال لیست سفید را برای مالک محتوا حذف می‌کند.
get GET /youtube/partner/v1/whitelists/{id}
یک کانال خاص در لیست سفید را بر اساس شناسه بازیابی می‌کند.
insert POST /youtube/partner/v1/whitelists
یک کانال یوتیوب را برای صاحب محتوای خود در لیست سفید قرار دهید.
list GET /youtube/partner/v1/whitelists
فهرستی از کانال‌های مجاز برای مالک محتوا را بازیابی می‌کند.