ملاحظة: إنّ واجهة برمجة تطبيقات Content ID في YouTube مُعدّة ليستخدمها شركاء المحتوى في YouTube ولا يمكن لجميع المطورين أو مستخدمي YouTube الوصول إليها. إذا كنت لا ترى YouTube Content ID API باعتبارها إحدى الخدمات المدرجة في وحدة التحكم في واجهة Google API، يُرجى مراجعة مركز مساعدة YouTube للحصول على المزيد من المعلومات حول "برنامج شركاء YouTube".
ملاحظة: تنطبق المعلومات الواردة في هذا الدليل على مواد عرض المقطوعات الموسيقية بشكل خاص.
في "استوديو YouTube"، يمكنك طلب إجراء تغييرات على مواد العرض الموسيقية التي تملكها. يمكنك أيضًا استخدام Content ID API لتنفيذ ما يلي:
- إنشاء طلبات التغيير
- إدراج حالة طلبات التغيير
تقدّم هذه الصفحة نظرة عامة حول طُرق MusicChangeRequest في Content ID API. كما يوفر أيضًا أمثلة حول كيفية إنشاء طلبات التغيير وسردها.
المتطلّبات
عليك الحصول على بيانات اعتماد التفويض لاستخدام واجهة برمجة التطبيقات هذه. ستستخدم رمز التفويض المميز في طلباتك.إذا كنت تستخدم cURL، احرص على إنشاء متغيّر AUTH_TOKEN
لاستخدامه في هذه الأوامر:
export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"
إنشاء طلب لتغيير الموسيقى
يمكنك استخدام طريقة musicChangeRequests.create
لتغيير إصدار أو مقطع صوتي. يجب أن يتضمن طلبك مورد طلب التغيير يحدد نوع التغيير الذي تريد إجراءه. يمكنك بعد ذلك إدراج طلبات التغيير للتحقّق من حالتها.
أنواع طلبات التغيير
تشمل أنواع الطلبات الصالحة ما يلي:
misreconciledArtist
: طلب تغيير الفنّان لإصدار أو مقطع صوتي يستخدمDesiredArtist
موردًا. استخدِم هذا الخيار إذا لم يكن مرتبطًا بالفنّان الأساسي أو الفنّان المشارك المطلوب.undesiredDiscography
: طلب تغيير قناة الفنّان المرتبطة بإصدار معيّن يمكنك استخدام هذا الخيار إذا كان الإصدار الخاص بفنّان آخر يظهر بشكل غير صحيح على قناة فنّان آخر.incorrectPlayability
: طلب تغيير إمكانية تشغيل إصدار أو مقطع صوتي معيّن استخدِم هذا الخيار إذا لم يكن بالإمكان تشغيل الفيديو أو رؤيته كما هو متوقَّع في المنتج.incorrectMusicVideo
: طلب تغيير الفيديو الموسيقي لمقطع صوتي يستخدمDesiredMusicVideo
موردًا. يمكنك استخدام هذا الخيار إذا لم يكن مرتبطًا بالفيديو الموسيقي المطلوب.incorrectMetadata
: يمكنك طلب تغيير التهجئة أو التنسيق أو الترجمة لإصدار أو مقطع صوتي.
مثال: الإصدار غير مرتبط بالفنان الأساسي أو المشارك المطلوب.
لنفترض أنّك أرسلت إصدارًا إلى YouTube Music، وكان اسم الفنّان غير صحيح في الإصدار. لتقديم طلب لإجراء هذا التغيير:
-
العثور على الإصدار المتأثّر بالمشكلة في "استوديو YouTube" انسخ رقم التعريف (مثل الرمز العالمي للمنتج) من صفحة "استوديو YouTube".
-
يمكنك إنشاء طلب يحتوي على عبارة JSON التالية:
'{ "release": "releases/0012345678901", "misreconciledArtist": { "channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change" } }'
release
هو المعرّف الخاص بالإصدار، ويمكنك العثور عليه في "استوديو YouTube".- تستخدم
misreconciledArtist
موردdesiredArtist
يتألف مما يلي:channelId
: معرّف قناة الفنّان الذي تريد نقل الإصدار إليه يمكنك الحصول على معرّف القناة من خلال الانتقال إلى قناة الفنّان على YouTube ونسخ المعرّف من عنوان 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]
.