REST Resource: assets

Recurso: recurso

Um recurso asset representa uma parte da propriedade intelectual, como uma gravação de som ou 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, certas funções da API só são compatíveis com tipos específicos de recursos. Por exemplo, os recursos de composição podem ter dados de propriedade mais complexos do que outros tipos.

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 pesquisar o recurso ou 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, como os territórios em que eles detém o 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 de forma exclusiva o recurso.

aliasId[]

string

Uma lista de códigos do recurso que podem ser usados para se referir ao recurso. A lista vai conter valores se o recurso representar vários recursos constituintes que foram mesclados. Nesse caso, qualquer um dos IDs de recursos originalmente atribuídos aos recursos constituintes pode ser usado para atualizar o recurso principal ou sintetizado.

label[]

string

Uma lista de rótulos de recurso no recurso.

licensability

object (AssetLicensability)

Informações sobre licenciamento de recursos

nWayRevenueSharing

object (NWayRevenueSharing)

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

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 os conflitos de propriedade de um recurso e os territórios em que a propriedade conflitante é inserida.

performance[]

object (TerritoryConflicts)

Uma lista que identifica os conflitos de propriedade relacionados aos 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 os 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 procurar terroristas com conflitos de propriedade.

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

string

Um território em que o conflito de propriedade esteja presente. O território é um código de país de duas letras do ISO 3166.

conflictingOwnership[]

object (ConflictingOwnership)

Uma lista de propriedades conflitantes.

ConflictingOwnership

Representam 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 licenciamento de recursos

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

boolean

Se o recurso reconciliado é licenciável.

licensabilityState

string

O estado de licenciamento do recurso.

unlicensableReason[]

string

É o motivo por que o recurso não é licenciável.

NWayRevenueSharing

Repartição de receita em vários sentidos do recurso de informação.

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

string

Status de participação na receita de n via.

eligibleTerritories[]

string

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

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

Informações sobre problemas em que um recurso não está qualificado para participação na receita de n via.

TerritoriesIneligibleForNWayRevenueSharing

Informações sobre os territórios em que um recurso não se qualifica para a repartição de receita de vários meios.

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

string

Motivo da não qualificação para os problemas listados abaixo.

territories[]

string

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

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

Aplica os patches aos metadados do recurso especificado.

update

Atualiza os metadados para o recurso especificado.