REST Resource: ownership

Resource: RightsOwnership

The rightsOwnership resource represents the ownership data for an asset. It identifies an asset's owners and provides additional details about their ownership, such as the territories where they own the asset.

JSON representation 
{
  "general": [
    {
      object (TerritoryOwners)
    }
  ],
  "performance": [
    {
      object (TerritoryOwners)
    }
  ],
  "synchronization": [
    {
      object (TerritoryOwners)
    }
  ],
  "mechanical": [
    {
      object (TerritoryOwners)
    }
  ],
  "kind": string
}
Fields
general[]

object (TerritoryOwners)

A list that identifies the owners of an asset and the territories where each owner has ownership. General asset ownership is used for all types of assets and is the only type of ownership data that can be provided for assets that are not compositions.

Note: You cannot specify general ownership rights and also specify either mechanical, performance, or synchronization rights.
performance[]

object (TerritoryOwners)

A list that identifies owners of the performance rights for a composition asset.
synchronization[]

object (TerritoryOwners)

A list that identifies owners of the synchronization rights for a composition asset.
mechanical[]

object (TerritoryOwners)

A list that identifies owners of the mechanical rights for a composition asset.
kind

string

The type of the API resource. For rightsOwnership resources, the value is youtubePartner#rightsOwnership.

TerritoryOwners

Represents ownership conflict in a single territory.

JSON representation 
{
  "type": string,
  "territories": [
    string
  ],
  "ratio": number,
  "owner": string,
  "publisher": string
}
Fields
type

string

This field indicates whether the ownership data applies or does not apply in the specified territories.
territories[]

string

A list of territories where the owner owns (or does not own) the asset. Each territory is an ISO 3166 two-letter country code..
ratio

number

The percentage of the asset that the owner controls or administers. For composition assets, the value can be any value between 0 and 100 inclusive. For all other assets, the only valid values are 100, which indicates that the owner completely owns the asset in the specified territories, and 0, which indicates that you are removing ownership of the asset in the specified territories.
owner

string

The name of the asset's owner or rights administrator.
publisher

string

The name of the asset's publisher. This field is only used for composition assets, and it is used when the asset owner is not known to have a formal relationship established with YouTube.

Methods

get

 Retrieves the ownership data provided for the specified asset by the content owner associated with the authenticated user.

patch

 Provides new ownership information for the specified asset.

update

 Provides new ownership information for the specified asset.