REST Resource: assets

Recurso: recurso

Um recurso asset representa uma propriedade intelectual, como uma gravação de som ou um episódio de televisão.

Representação 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

O tipo do recurso da API. Para recursos asset, o valor é youtubePartner#asset.

type

string

O tipo do recurso. Esse valor determina os campos de metadados que podem ser definidos para o recurso. Além disso, algumas funções da API só têm suporte para tipos específicos de recursos. Por exemplo, os recursos de composição podem ter dados de propriedade mais complexos do que outros tipos de recursos.

Os valores válidos para esta propriedade são:

  • art_track_video

  • composition

  • episode

  • general

  • movie

  • music_video

  • season

  • show

  • sound_recording

  • video_game

  • web

status

string

O status do recurso.

metadata

object (Metadata)

O objeto metadata contém informações que identificam e descrevem o recurso. Essas informações podem ser usadas para procurar o recurso ou para eliminar duplicação no banco de dados do YouTube.

ownership

object (RightsOwnership)

O objeto ownership identifica os proprietários de um recurso e fornece detalhes adicionais sobre a propriedade deles, como os territórios em que eles são proprietários do recurso.

matchPolicy

object (AssetMatchPolicy)

O objeto matchPolicy contém informações sobre a política de correspondência do recurso, que o YouTube aplica aos vídeos enviados por usuários que correspondem ao recurso.

timeCreated

string

A data e a hora em que o recurso foi criado. O valor é especificado no 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)

O objeto ownershipConflicts contém informações sobre os conflitos de propriedade do recurso.

id

string

Um ID que o YouTube atribui e usa para identificar exclusivamente o recurso.

aliasId[]

string

Uma lista de IDs de recurso que podem ser usados para fazer referência ao recurso. A lista vai incluir valores se o recurso representar vários recursos constituintes que foram mesclados. Nesse caso, qualquer um dos IDs de recurso originalmente atribuídos aos recursos constituintes pode ser usado para atualizar o recurso principal ou sintetizado.

label[]

string

Uma lista de rótulos de recursos.

licensability

object (AssetLicensability)

Informações sobre o licenciamento de recursos.

nWayRevenueSharing

object (NWayRevenueSharing)

Informações sobre participação na receita (Pangea).

OwnershipConflicts

O recurso ownershipConflicts representa informações sobre a propriedade conflitante do recurso.

Representação JSON
{
  "general": [
    {
      object (TerritoryConflicts)
    }
  ],
  "performance": [
    {
      object (TerritoryConflicts)
    }
  ],
  "synchronization": [
    {
      object (TerritoryConflicts)
    }
  ],
  "mechanical": [
    {
      object (TerritoryConflicts)
    }
  ],
  "kind": string
}
Campos
general[]

object (TerritoryConflicts)

Uma lista que identifica conflitos de propriedade de um recurso e os territórios em que a propriedade conflitante está inserida.

performance[]

object (TerritoryConflicts)

Uma lista que identifica conflitos de propriedade dos direitos de execução de um recurso de composição e os territórios em que a propriedade conflitante é inserida.

synchronization[]

object (TerritoryConflicts)

Uma lista que identifica conflitos de propriedade dos direitos de sincronização de um recurso de composição e os territórios em que a propriedade conflitante é inserida.

mechanical[]

object (TerritoryConflicts)

Uma lista que identifica conflitos de propriedade dos direitos mecânicos de um recurso de composição e os territórios em que a propriedade conflitante é inserida.

kind

string

O tipo do recurso da API. Para recursos ownershipConflicts, o valor é youtubePartner#ownershipConflicts.

TerritoryConflicts

Método para pesquisar terroristas com conflitos de propriedade.

Representação JSON
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
Campos
territory

string

Territórios em que há conflito de propriedade. O território é um código de país de duas letras do ISO 3166.

conflictingOwnership[]

object (ConflictingOwnership)

Uma lista de propriedades conflitantes.

ConflictingOwnership

Representa informações sobre uma das propriedades conflitantes.

Representação JSON
{
  "ratio": number,
  "owner": string
}
Campos
ratio

number

A porcentagem do recurso que o proprietário controla ou administra.

owner

string

O ID do proprietário do recurso conflitante.

AssetLicensability

Informações sobre o licenciamento de recursos.

Representação JSON
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
Campos
licensable

boolean

Indica se o recurso reconciliado é licenciável.

licensabilityState

string

O estado de licenciamento do recurso.

unlicensableReason[]

string

O motivo pelo qual o recurso não é licenciável.

NWayRevenueSharing

Repartição de receita nivelada do recurso de informação.

Representação JSON
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
Campos
status

string

Status da participação na receita n-direcional.

eligibleTerritories[]

string

Cada país é representado pelo código de país ISO 3166-1 alfa-2 de duas letras.

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

Informações sobre territórios em que um recurso não está qualificado para participação na receita n.

TerritoriesIneligibleForNWayRevenueSharing

Informações sobre territórios onde um recurso não está qualificado para participação nos lucros n-vias.

Representação JSON
{
  "reason": string,
  "territories": [
    string
  ]
}
Campos
reason

string

Motivo da inelegibilidade para os territórios listados abaixo.

territories[]

string

Cada país é representado pelo código de país ISO 3166-1 alfa-2 de duas letras.

Métodos

get

Recupera os metadados para o recurso especificado.

insert

Insere um recurso com os metadados especificados.

list

Recupera uma lista de recursos com base nos metadados do recurso.

patch

Corta os metadados do recurso especificado.

update

Atualiza os metadados para o recurso especificado.