REST Resource: ownership

Recurso: RightsOwnership

El recurso rightsOwnership representa los datos de propiedad de un activo. Este recurso identifica a los propietarios de un elemento y proporciona detalles adicionales sobre su propiedad, como los territorios en los que poseen el elemento.

Representación JSON
{
  "general": [
    {
      object (TerritoryOwners)
    }
  ],
  "performance": [
    {
      object (TerritoryOwners)
    }
  ],
  "synchronization": [
    {
      object (TerritoryOwners)
    }
  ],
  "mechanical": [
    {
      object (TerritoryOwners)
    }
  ],
  "kind": string
}
Campos
general[]

object (TerritoryOwners)

Una lista que identifica a los propietarios de un activo y los territorios en los que tiene propiedad cada uno. La propiedad general de activos se usa para todo tipo de activos y es el único tipo de datos de propiedad que se puede proporcionar para los activos que no sean composiciones.

Nota: No puedes especificar los derechos de propiedad general y también los derechos mecánicos, de rendimiento o de sincronización.

performance[]

object (TerritoryOwners)

Es una lista que identifica a los propietarios de los derechos de ejecución de un activo de composición.

synchronization[]

object (TerritoryOwners)

Una lista que identifica a los propietarios de los derechos de sincronización de un elemento de composición.

mechanical[]

object (TerritoryOwners)

Es una lista que identifica a los propietarios de los derechos mecánicos de un activo de composición.

kind

string

Tipo de recurso de la API. Para los recursos rightsOwnership, el valor es youtubePartner#rightsOwnership.

TerritoryOwners

Representa el conflicto de propiedad en un solo territorio.

Representación JSON
{
  "type": string,
  "territories": [
    string
  ],
  "ratio": number,
  "owner": string,
  "publisher": string
}
Campos
type

string

Este campo indica si los datos de propiedad se aplican o no en los territorios especificados.

territories[]

string

Es una lista de los territorios en los que el propietario posee (o no) el activo. Cada territorio es un código de país ISO 3166 de dos letras.

ratio

number

El porcentaje del elemento que el propietario controla o administra. En el caso de los recursos de composición, el valor puede ser cualquier valor entre 0 y 100 inclusive. Para todos los demás activos, los únicos valores válidos son 100, que indica que el propietario posee por completo el activo en los territorios especificados, y 0, que indica que quitarás la propiedad del activo en los territorios especificados.

owner

string

El nombre del propietario o del administrador de derechos del activo.

publisher

string

El nombre del publicador del activo. Este campo solo se utiliza para los activos de composición y cuando se desconoce el propietario del activo que tiene una relación formal establecida con YouTube.

Métodos

get

Recupera la política de propiedad asignada al elemento determinado por el propietario del contenido asociado al usuario autenticado.

patch

Proporciona información de propiedad nueva para el elemento especificado.

update

Proporciona información de propiedad nueva para el elemento especificado.