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 activo. Además, es posible que ciertas funciones de la API solo sean compatibles con tipos específicos de recursos. 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

El estado del activo.

metadata

object (Metadata)

El objeto metadata contiene información que identifica y describe el recurso. Esta información se puede usar 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, que YouTube aplica a los videos subidos por usuarios que coincidan con el activo.

timeCreated

string

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 elemento de forma exclusiva.

aliasId[]

string

Lista de los ID de los 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 elemento asignados originalmente a los elementos constituyentes se podría utilizar para actualizar el elemento principal o sintetizado.

label[]

string

Una lista de las etiquetas del activo.

licensability

object (AssetLicensability)

Información sobre la licencia del activo.

nWayRevenueSharing

object (NWayRevenueSharing)

Información de reparto de ingresos de N forma (Pangea).

OwnershipConflicts

El recurso ownershipConflicts representa información acerca de los conflictos de propiedad del activo.

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

object (TerritoryConflicts)

Lista en la que se identifican los conflictos de propiedad de un activo y los territorios en los que se insertan.

performance[]

object (TerritoryConflicts)

Una lista que identifica los conflictos de propiedad de los derechos de ejecución de un activo de composición y los territorios en los que se insertan.

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 insertan.

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 insertan.

kind

string

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

TerritoryConflicts

Método para buscar terrores con conflictos de propiedad.

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

string

Un territorio en el que está presente el 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

El porcentaje del elemento que el propietario controla o administra.

owner

string

El ID del propietario del activo en conflicto.

AssetLicensability

Información sobre la licencia del activo.

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

boolean

Si el activo conciliado está disponible bajo licencia.

licensabilityState

string

El estado de licencia del activo.

unlicensableReason[]

string

El motivo por el que el activo no está disponible bajo licencia.

NWayRevenueSharing

Reparto de ingresos n-way de los recursos de información.

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

string

Estado del reparto de ingresos de varias vías.

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 n way.

TerritoriesIneligibleForNWayRevenueSharing

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

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

string

Motivo de inelegibilidad 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 para el elemento especificado.

update

Actualiza los metadatos del elemento especificado.