توجه: YouTube Content ID API برای استفاده شرکای محتوای YouTube در نظر گرفته شده است و برای همه توسعه دهندگان یا همه کاربران YouTube قابل دسترسی نیست. اگر API شناسه محتوای YouTube را بهعنوان یکی از سرویسهای فهرست شده در Google API Console نمیبینید، برای کسب اطلاعات بیشتر درباره YouTube Partner Program به مرکز راهنمایی YouTube مراجعه کنید.
توجه: اطلاعات این راهنما به طور خاص برای دارایی های ترکیب اعمال می شود.
در استودیوی YouTube، میتوانید تغییراتی در داراییهای موسیقی متعلق به خود درخواست کنید . همچنین میتوانید از Content ID API برای موارد زیر استفاده کنید:
- ایجاد درخواست تغییر
- فهرست وضعیت درخواستهای تغییر
این صفحه یک نمای کلی از روشهای MusicChangeRequest در Content ID API ارائه میکند. همچنین نمونه هایی از نحوه ایجاد و فهرست کردن درخواست های تغییر را ارائه می دهد.
الزامات
برای استفاده از این API باید اعتبارنامه مجوز را دریافت کنید . شما از رمز مجوز خود در درخواست های خود استفاده خواهید کرد. اگر از cURL استفاده میکنید، حتماً یک متغیر AUTH_TOKEN
برای استفاده در این دستورات ایجاد کنید:
export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"
درخواست تغییر موسیقی ایجاد کنید
شما از روش musicChangeRequests.create
برای تغییر انتشار یا آهنگ استفاده می کنید. درخواست شما باید شامل یک منبع درخواست تغییر باشد که نوع تغییری را که می خواهید انجام دهید مشخص می کند. سپس میتوانید درخواستهای تغییر خود را فهرست کنید تا وضعیت آنها را بررسی کنید.
انواع درخواست تغییر
انواع درخواست های معتبر عبارتند از:
-
misreconciledArtist
: درخواست تغییر هنرمند برای انتشار یا آهنگ. یک منبعDesiredArtist
را می گیرد. اگر با هنرمند اصلی یا برجسته مورد نظر مرتبط نیست از این گزینه استفاده کنید. -
undesiredDiscography
: درخواست تغییر کانال هنرمند مرتبط با انتشار. اگر انتشار هنرمند دیگری به اشتباه در کانال یک هنرمند ظاهر می شود از این گزینه استفاده کنید. -
incorrectPlayability
: درخواست تغییر قابلیت پخش یک نسخه یا آهنگ. اگر آنطور که انتظار می رود در محصول قابل پخش نیست از این گزینه استفاده کنید. -
incorrectMusicVideo
: درخواست تغییر موزیک ویدیوی آهنگ. یک منبعDesiredMusicVideo
را می گیرد. اگر با موزیک ویدیوی مورد نظر مرتبط نیست از این گزینه استفاده کنید. -
incorrectMetadata
: درخواست تغییر املا، قالب بندی یا ترجمه یک نسخه یا آهنگ.
مثال: انتشار با هنرمند اصلی یا برجسته مورد نظر مرتبط نیست
فرض کنید نسخهای را به YouTube Music ارسال کردهاید، اما این نسخه دارای هنرمند نادرستی مرتبط با آن است. برای درخواست این تغییر:
محل انتشار آسیبدیده را در YouTube Studio پیدا کنید. شماره شناسه (مانند UPC) را از صفحه YouTube Studio کپی کنید.
درخواستی ایجاد کنید که حاوی عبارت JSON زیر باشد:
'{ "release": "releases/0012345678901", "misreconciledArtist": { "channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change" } }'
-
release
شماره شناسه نسخه است که می توانید آن را در استودیوی YouTube پیدا کنید. -
misreconciledArtist
یک منبعdesiredArtist
را می گیرد که شامل موارد زیر است:-
channelId
: شناسه کانال برای هنرمندی که میخواهید انتشار را به او منتقل کنید. با مراجعه به کانال هنرمند در یوتیوب و کپی کردن شناسه از URL می توانید شناسه کانال را دریافت کنید. اگر هنرمند وجود ندارد و هنرمند جدیدی است،channelId
خالی بگذارید وnewArtist: true
. -
newArtist
: اگر هنرمند در حال حاضر در YouTube Music نیست، این قسمت راtrue
علامت بزنید. در غیر این صورت، اگر شناسه کانال ارائه کرده اید، این قسمت راfalse
علامت گذاری کنید. -
supplementalInfo
: نظرات اختیاری در مورد درخواست.
-
-
برای درخواست از روش
musicChangeRequests.create
استفاده کنید. JSON حاوی درخواست را وارد کنید. به عنوان مثال، دستور زیر نشان می دهد که چگونه می توانید این درخواست را با cURL انجام دهید:curl -v -H "Authorization: Bearer $AUTH_TOKEN" --json '{"release": "releases/0012345678901", "misreconciledArtist": {"channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change"}}' https://www.googleapis.com/youtube/partner/v1/music/changeRequests
لیست درخواست های تغییر
برای بازیابی لیستی از درخواست های تغییر موسیقی گزارش شده، از روش musicChangeRequests.list
استفاده می کنید. این روش با لیستی از درخواستهای تغییر پاسخ میدهد که توسط مالک محتوا فیلتر شده است. همچنین میتوانید نتایج را بر اساس انتشار یا پیگیری و بر اساس مالک محتوا فیلتر کنید.
مثال: فهرست درخواستهای تغییر برای یک نسخه خاص
فرض کنید باید درخواستهای تغییر را برای یک نسخه خاص با مالک محتوای دیگری دریافت کنید. دستور زیر نمونه ای از نحوه انجام این درخواست با cURL است:
curl -v -H "Authorization: Bearer $AUTH_TOKEN" https://www.googleapis.com/youtube/partner/v1/music/changeRequests?onBehalfOfContentOwner=91U_FgOL8S7d52aNESfMaw&filter.parent=releases/0999999999999
جایی که:
-
onBehalfOfContentOwner
شناسه کانال مالک محتوا است که مالک انتشار یا تراک است. -
filter
یکrelease/[RELEASE_ID_NUMBER]
یاtrack/[TRACK_ID_NUMBER]
را مشخص میکند.