REST Resource: ownership

المرجع: ملكية الحقوق

يمثل المورد rightsOwnership بيانات الملكية لمادة العرض. وهي تحدد مالكي مادة العرض وتقدّم تفاصيل إضافية حول ملكيتهم، مثل المناطق التي يملكون فيها مادة العرض.

تمثيل JSON 
{
  "general": [
    {
      object (TerritoryOwners)
    }
  ],
  "performance": [
    {
      object (TerritoryOwners)
    }
  ],
  "synchronization": [
    {
      object (TerritoryOwners)
    }
  ],
  "mechanical": [
    {
      object (TerritoryOwners)
    }
  ],
  "kind": string
}
الحقول
general[]

object (TerritoryOwners)

قائمة تحدد مالكي مادة العرض والأقاليم حيث تعود ملكيتها إليهم. تُستخدم الملكية العامة لمادة العرض لكل أنواع مواد العرض وهي النوع الوحيد من بيانات الملكية التي يمكن تقديمها لمواد العرض التي ليست مقطوعات موسيقية.

ملاحظة: لا يمكنك تحديد حقوق الملكية العامة، كما لا يمكنك تحديد حقوق الملكية الميكانيكية أو حقوق الأداء أو المزامنة.
performance[]

object (TerritoryOwners)

قائمة تحدد مالكي حقوق الأداء لمادة عرض مقطوعة موسيقية.
synchronization[]

object (TerritoryOwners)

قائمة تحدد مالكي حقوق المزامنة لمادة عرض مقطوعة موسيقية
mechanical[]

object (TerritoryOwners)

قائمة تحدد مالكي الحقوق الميكانيكية لمادة عرض مقطوعة موسيقية
kind

string

نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى rightsOwnership موارد، تكون القيمة youtubePartner#rightsOwnership.

TerritoryOwners

يمثل النزاع على الملكية في منطقة واحدة.

تمثيل JSON 
{
  "type": string,
  "territories": [
    string
  ],
  "ratio": number,
  "owner": string,
  "publisher": string
}
الحقول
type

string

يشير هذا الحقل إلى ما إذا كانت بيانات الملكية تنطبق على المناطق المحدّدة أم لا.
territories[]

string

قائمة بالأقاليم حيث يملك (أو لا يملك) المالك مادة العرض. وكلّ منطقة هي رمز بلد مؤلف من حرفَين وفقًا لمعيار ISO 3166.
ratio

number

النسبة المئوية لمادة العرض التي يتحكّم بها المالك أو يديرها. بالنسبة إلى مواد عرض المقطوعات الموسيقية، يمكن أن تكون القيمة أي قيمة تتراوح بين 0 و100. أمّا في ما يتعلق بمواد العرض الأخرى، فتتمثل القيم الصالحة فقط في 100، ما يشير إلى أنّ المالك يملك مادة العرض بالكامل في الأقاليم المحددة، والقيم 0 التي تشير إلى أنك تزيل ملكية مادة العرض في الأقاليم المحددة.
owner

string

اسم مالك مادة العرض أو مسؤول الحقوق
publisher

string

اسم ناشر مادة العرض يُستخدم هذا الحقل فقط لمواد عرض المقطوعات الموسيقية، ويُستخدم عندما لا يكون لدى مالك مادة العرض علاقة رسمية بـ YouTube.

الطُرق

get

 لاسترداد بيانات الملكية التي قدّمها مالك المحتوى المرتبط بالمستخدم الذي تمت مصادقته لمادة العرض المحددة.

patch

 يقدم معلومات ملكية جديدة لمادة العرض المحددة.

update

 يقدم معلومات ملكية جديدة لمادة العرض المحددة.