REST Resource: musicChangeRequests

المرجع: MusicChangeRequest

تمثيل لطلب تغيير الموسيقى

تمثيل JSON 
{
  "name": string,
  "createTime": string,
  "type": string,
  "state": enum (State),

  // Union field parent can be only one of the following:
  "release": string,
  "track": string
  // End of list of possible types for union field parent.

  // Union field details can be only one of the following:
  "misreconciledArtist": {
    object (DesiredArtist)
  },
  "undesiredDiscography": {
    object (UndesiredDiscography)
  },
  "incorrectPlayability": {
    object (IncorrectPlayability)
  },
  "incorrectMusicVideo": {
    object (DesiredMusicVideo)
  },
  "incorrectMetadata": {
    object (IncorrectMetadata)
  }
  // End of list of possible types for union field details.
}
الحقول
name

string

النتائج فقط. المعرّف اسم المورد لطلب التغيير التنسيق: changeRequests/{changeRequest}
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء طلب التغيير.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
type

string

النتائج فقط. نوع طلب التغيير القيم المحتملة: misreconciledArtist، وincorrectMetadata، وincorrectArtists، وundesiredReleaseDiscography، وincorrectPlayability، وincorrectTrackMusicVideo.
state

enum (State)

النتائج فقط. حالة طلب التغيير
حقل الربط parent العنصر الرئيسي لطلب التغيير الذي يمكن أن يكون إصدارًا أو مقطعًا صوتيًا. يمكن أن يكون parent واحدًا فقط مما يلي:
release

string

التنسيق: releases/{release}
track

string

التنسيق: releases/{release}/tracks/{track}
حقل الربط details الإدخال فقط معلومات مفصّلة عن ChangeRequest يمكن أن يكون details واحدًا فقط مما يلي:
misreconciledArtist

object (DesiredArtist)

الإدخال فقط يتطابق مع نوع misreconciledArtist.
undesiredDiscography

object (UndesiredDiscography)

الإدخال فقط يتوافق مع نوع undesiredReleaseDiscography.
incorrectPlayability

object (IncorrectPlayability)

الإدخال فقط تتوافق مع نوع incorrectPlayability.
incorrectMusicVideo

object (DesiredMusicVideo)

الإدخال فقط تتوافق مع نوع incorrectTrackMusicVideo.
incorrectMetadata

object (IncorrectMetadata)

الإدخال فقط تتوافق مع نوع البيانات الوصفية غير الصحيح.

الحالة

القيم المحتمَلة لحالة طلبات التغيير

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
OPEN طلب التغيير لم يتم حلّه.
CLOSED أغلق أحد موظّفي الدعم طلب التغيير (ربما بدون إجراء أيّ شيء).
EXPIRED تم إغلاق طلب التغيير بدون حلّ من مشغل الشبكة.

DesiredArtist

الفنّان المطلوب للمطابقة، كما حدّده الشريك

تمثيل JSON 
{
  "channelId": string,
  "newArtist": boolean,
  "supplementalInfo": string
}
الحقول
channelId

string

معرّف قناة الفنّان المطلوب
newArtist

boolean

القيمة true إذا لم يكن هناك فنّان حالي لربطه بالإصدار. يجب عدم ضبط channelId إذا كانت هذه القيمة صحيحة.
supplementalInfo

string

معلومات تكميلية عامة

UndesiredDiscography

يتوافق مع خيار "يظهر الإصدار الخاص بفنّان آخر بشكل غير صحيح على قناة الفنّان الخاصة بي".

تمثيل JSON 
{
  "channelId": string,
  "undesiredPlaylistIds": [
    string
  ],
  "supplementalInfo": string
}
الحقول
channelId

string

معرّف قناة الفنّان الذي يملك أعمال الإصدار غير المرغوب فيه
undesiredPlaylistIds[]

string

أرقام تعريف قوائم التشغيل الخاصة بالإصدارات غير المطلوبة
supplementalInfo

string

معلومات تكميلية عامة

IncorrectPlayability

يتوافق مع الخيار "(الإصدار / المقطع الصوتي الفني) لا يمكن تشغيله أو رؤيته كما هو متوقَّع في المنتج".

تمثيل JSON 
{
  "rightsTypes": [
    enum (ChangeRequestRightsType)
  ],
  "surfaces": [
    enum (ChangeRequestSurface)
  ],
  "territorySet": {
    object (TerritorySet)
  },
  "supplementalInfo": string
}
الحقول
rightsTypes[]

enum (ChangeRequestRightsType)

أنواع الحقوق التي ينطبق عليها طلب التغيير الذي تم الإبلاغ عنه
surfaces[]

enum (ChangeRequestSurface)

مساحات العرض التي ينطبق عليها طلب التغيير الذي تم الإبلاغ عنه
territorySet

object (TerritorySet)

المناطق التي ينطبق عليها طلب التغيير الذي تم الإبلاغ عنه
supplementalInfo

string

معلومات تكميلية عامة

ChangeRequestRightsType

نوع الحقوق المتأثرة بطلب التغيير الذي تم الإبلاغ عنه.

عمليات التعداد
CHANGE_REQUEST_RIGHTS_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
AVOD الفيديوهات عند الطلب التي تتضمّن إعلانات
SVOD فيديو عند الطلب مقابل اشتراك

ChangeRequestSurface

السطح المتأثر بطلب تغيير تم الإبلاغ عنه

عمليات التعداد
CHANGE_REQUEST_SURFACE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
YOUTUBE_MUSIC تطبيق YouTube Music
YOUTUBE YouTube Main

TerritorySet

مجموعة من المناطق

تمثيل JSON 
{
  "everywhereComplement": boolean,
  "regionCodes": [
    string
  ]
}
الحقول
everywhereComplement

boolean

إذا كانت القيمة صحيحة، يشكّل ذلك مجموعة مكمّلة للمجموعة أدناه من regionCodes. يُرجى العلم أنّه إذا كان هذا صحيحًا وكان حقل regionCodes فارغًا، يعني ذلك أنّه في كل مكان.
regionCodes[]

string

قائمة المناطق التي تتضمّن تنسيق Unicode CLDR

DesiredMusicVideo

الفيديو الموسيقي المطلوب ربطه بمقطع صوتي فني، على النحو الذي يحدّده الشريك

تمثيل JSON 
{
  "videoId": string,
  "noMusicVideo": boolean,
  "territorySet": {
    object (TerritorySet)
  },
  "supplementalInfo": string
}
الحقول
videoId

string

رقم تعريف الفيديو الموسيقي المطلوب ربطه بالأغنية
noMusicVideo

boolean

يتم ضبطه على "صحيح" إذا لم يكن من المفترض أن يكون هناك فيديو موسيقي مرتبط بالمقطع الصوتي. يجب عدم ضبط videoId إذا كان هذا صحيحًا.
territorySet

object (TerritorySet)

المناطق التي ينطبق فيها ربط الفيديو الموسيقي هذا
supplementalInfo

string

معلومات تكميلية عامة

IncorrectMetadata

يتوافق مع خيارَي "(الإصدار / المقطع الصوتي الفني) الذي أرسلتُه يتضمّن تنسيقًا أو تهجئة أو ترجمة غير صحيحة" و"(الإصدار / المقطع الصوتي الفني) الذي أرسلتُه يضمّ الفنّان الأساسي أو الفنّان المشارك الخاطئَين".

تمثيل JSON 
{
  "supplementalInfo": string
}
الحقول
supplementalInfo

string

معلومات تكميلية عامة

الطُرق

create

 تُنشئ هذه العملية طلبًا لتغيير الموسيقى تم الإبلاغ عنه في إصدار أو مقطع صوتي.

list

 يسترجع هذا الطلب قائمة بطلبات تغيير الموسيقى التي تم الإبلاغ عنها في إصدار أو مقطع صوتي.