REST Resource: assets

Recurso: Asset

Un recurso asset representa una pieza de propiedad intelectual, como una grabación de sonido o un episodio de televisión.

Representación JSON
{
  "kind": string,
  "type": string,
  "status": string,
  "metadata": {
    object (Metadata)
  },
  "ownership": {
    object (RightsOwnership)
  },
  "matchPolicy": {
    object (AssetMatchPolicy)
  },
  "timeCreated": string,
  "metadataMine": {
    object (Metadata)
  },
  "metadataEffective": {
    object (Metadata)
  },
  "ownershipMine": {
    object (RightsOwnership)
  },
  "ownershipEffective": {
    object (RightsOwnership)
  },
  "matchPolicyMine": {
    object (AssetMatchPolicy)
  },
  "matchPolicyEffective": {
    object (AssetMatchPolicy)
  },
  "ownershipConflicts": {
    object (OwnershipConflicts)
  },
  "id": string,
  "aliasId": [
    string
  ],
  "label": [
    string
  ],
  "licensability": {
    object (AssetLicensability)
  },
  "nWayRevenueSharing": {
    object (NWayRevenueSharing)
  }
}
Campos
kind

string

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

type

string

El tipo de activo. Este valor determina los campos de metadatos que puedes configurar para el elemento. Además, es posible que ciertas funciones de la API solo sean compatibles con tipos específicos de elementos. Por ejemplo, los activos de composición pueden tener datos de propiedad más complejos que otros tipos de activos.

Los valores válidos para esta propiedad son:

  • art_track_video

  • composition

  • episode

  • general

  • movie

  • music_video

  • season

  • show

  • sound_recording

  • video_game

  • web

status

string

Estado del recurso.

metadata

object (Metadata)

El objeto metadata contiene información que identifica y describe el recurso. Esta información se puede utilizar para buscar el elemento o para eliminar la duplicación dentro de la base de datos de YouTube.

ownership

object (RightsOwnership)

El objeto ownership identifica a los propietarios de un activo y proporciona detalles adicionales sobre su propiedad, como los territorios en los que son propietarios del activo.

matchPolicy

object (AssetMatchPolicy)

El objeto matchPolicy contiene información sobre la política de coincidencias del activo. YouTube aplica a los videos subidos por usuarios que coincidan con el activo.

timeCreated

string

La fecha y hora en que se creó el activo. El valor se especifica en formato RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).

metadataMine

object (Metadata)

metadataEffective

object (Metadata)

ownershipMine

object (RightsOwnership)

ownershipEffective

object (RightsOwnership)

matchPolicyMine

object (AssetMatchPolicy)

matchPolicyEffective

object (AssetMatchPolicy)

ownershipConflicts

object (OwnershipConflicts)

El objeto ownershipConflicts contiene información sobre los conflictos de propiedad del activo.

id

string

ID que YouTube asigna y utiliza para identificar el activo de manera única.

aliasId[]

string

Es una lista de los IDs de activos que se pueden usar para hacer referencia al activo. La lista contiene valores si el activo representa varios activos constituyentes que se combinaron. En ese caso, cualquiera de los ID de activos asignados originalmente a los activos constituyentes, podría usarse para actualizar el activo principal o sintetizado.

label[]

string

Lista de etiquetas de activos del activo.

licensability

object (AssetLicensability)

Información sobre la licencia de los activos.

nWayRevenueSharing

object (NWayRevenueSharing)

Información sobre el reparto de ingresos (Pangea) de N manera.

OwnershipConflicts

El recurso ownershipConflicts representa información sobre el conflicto de propiedad de un elemento.

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

object (TerritoryConflicts)

Una lista que identifica los conflictos de propiedad de un activo y los territorios en los que se insertaron.

performance[]

object (TerritoryConflicts)

Una lista que identifica los conflictos de propiedad de los derechos de ejecución de un elemento de composición y los territorios en los que se insertó el conflicto de propiedad.

synchronization[]

object (TerritoryConflicts)

Una lista que identifica los conflictos de propiedad de los derechos de sincronización de un elemento de composición y los territorios en los que se insertó el conflicto de propiedad.

mechanical[]

object (TerritoryConflicts)

Una lista que identifica los conflictos de propiedad de los derechos mecánicos de un activo de composición y los territorios en los que se insertó el conflicto de propiedad.

kind

string

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

TerritoryConflicts

Método para buscar terrorismo con conflictos de propiedad.

Representación JSON
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
Campos
territory

string

Es un territorio en el que existe un conflicto de propiedad. El territorio es un código de país ISO 3166 de dos letras.

conflictingOwnership[]

object (ConflictingOwnership)

Una lista de propiedades en conflicto.

ConflictingOwnership

Representa información sobre una de las propiedades en conflicto.

Representación JSON
{
  "ratio": number,
  "owner": string
}
Campos
ratio

number

Porcentaje del activo que el propietario controla o administra.

owner

string

El ID del propietario del activo en conflicto.

AssetLicensability

Información sobre la licencia de los activos.

Representación JSON
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
Campos
licensable

boolean

Indica si el activo conciliado puede estar bajo licencia.

licensabilityState

string

El estado de disponibilidad de licencia del activo.

unlicensableReason[]

string

El motivo por el cual el activo no está bajo licencia.

NWayRevenueSharing

Reparto de ingresos n-forma del recurso de información

Representación JSON
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
Campos
status

string

Estado del reparto de ingresos n-way.

eligibleTerritories[]

string

Cada país está representado por su código de país ISO de dos letras (ISO 3166-1 alpha-2).

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

Información sobre los territorios en los que un activo no es apto para el reparto de ingresos bidireccional.

TerritoriesIneligibleForNWayRevenueSharing

Información sobre los territorios en los que un activo no es apto para el reparto de ingresos bidireccional.

Representación JSON
{
  "reason": string,
  "territories": [
    string
  ]
}
Campos
reason

string

Motivo de no elegibilidad para los territorios que se indican a continuación.

territories[]

string

Cada país está representado por su código de país ISO de dos letras (ISO 3166-1 alpha-2).

Métodos

get

Recupera los metadatos del elemento especificado.

insert

Inserta un elemento con los metadatos especificados.

list

Recupera una lista de elementos a partir de los metadatos de elementos.

patch

Aplica parches a los metadatos del elemento especificado.

update

Actualiza los metadatos del elemento especificado.