REST Resource: ownership

资源：RightsOwnership

rightsOwnership 资源表示资产的所有权数据。它用于标识资产的所有者，并提供有关其所有权的其他详细信息，例如他们拥有资产的国家/地区。

如果您想更新当前归其他内容所有者所有的资产，则必须先使用 ownership.update 或 ownership.patch 方法将您的所有权添加到该资产，然后才能使用 assets.update 或 assets.patch 更新其元数据，或使用 assetMatchPolicy.update 或 assetMatchPolicy.patch 更新其匹配政策。

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

API 资源的类型。对于 rightsOwnership 资源，值为 youtubePartner#rightsOwnership。

TerritoryOwners

表示单个地区的所有权冲突。

JSON 表示法 
{
  "type": string,
  "territories": [
    string
  ],
  "ratio": number,
  "owner": string,
  "publisher": string
}
字段
type

string

此字段用于指明所有权数据是否适用于指定国家/地区。

可接受的值包括：

  • exclude
  • include
territories[]

string

所有者拥有（或不拥有）资产的地区列表。每个地区都是一个 ISO 3166。
ratio

number

所有者控制或管理的资产的百分比。对于组合素材资源，该值可以是介于 0 和 100 之间的任何值（含边界值）。对于所有其他资产，唯一有效的值是 100（表示所有者在指定地区完全拥有资产）和 0（表示您要移除其在指定地区对此资产的所有权）。
owner

string

资源所有者或版权管理员的名称。
publisher

string

相应资产的发布商名称。此字段仅用于合成资产，并且仅在无法确定资产所有者是否与 YouTube 建立了正式关系时使用。

方法

get

 检索与经过身份验证的用户相关联的内容所有者为指定资源提供的所有权数据。

patch

 为指定资产提供新的所有权信息。

update

 为指定资产提供新的所有权信息。