Method: assets.get

Recupera os metadados para o recurso especificado. Se a solicitação identificar um recurso que foi combinado com outro recurso, o que significa que o YouTube identificou o recurso solicitado como duplicado, a solicitação recuperará o recurso combinado ou sintetizado.

Solicitação HTTP

GET https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
assetId

string

O parâmetro assetId especifica o ID do recurso do YouTube que está sendo recuperado.

Parâmetros de consulta

Parâmetros
fetchMatchPolicy

string

O parâmetro fetchMatchPolicy especifica a versão da política de correspondência do recurso que precisa ser retornada na resposta da API.

O parâmetro fetchMatchPolicy especifica uma lista separada por vírgulas das versões da política de correspondência do recurso que precisa ser retornada na resposta da API. O campo matchPolicy descontinuado só é definido se exatamente um valor de fetchMatchPolicy for especificado. Os valores aceitáveis são:

  • effective: recupera a política de correspondência que o YouTube aplica ao recurso.
  • mine: recupera a política de correspondência definida pelo proprietário de conteúdo padrão do usuário autenticado.
  • none: não recupera a política de correspondência do recurso. Esse é o valor padrão.
fetchMetadata

string

O parâmetro fetchMetadata especifica a versão dos metadados do recurso que precisam ser retornados na resposta da API. Em alguns casos, o YouTube recebe metadados de um recurso de várias fontes, por exemplo, quando diferentes parceiros são proprietários do recurso em territórios diferentes.
fetchOwnership

string

O parâmetro fetchOwnership especifica a versão dos dados de propriedade do recurso que precisam ser retornados na resposta da API. Assim como acontece com os metadados, o YouTube pode receber dados de propriedade de recursos de várias fontes.

O parâmetro fetchOwnership especifica uma lista separada por vírgulas de versões dos dados de propriedade do recurso que precisam ser retornados na resposta da API. Assim como nos metadados do recurso, o YouTube pode receber dados de propriedade de recursos de várias fontes.

O campo ownership descontinuado só é definido se exatamente um valor de fetchOwnership for especificado.

Os valores aceitos são:

  • canonical: este parâmetro foi descontinuado. Consulte effective.
  • effective: extrai os dados de propriedade que o YouTube determinou algoritmicamente como os mais precisos para o recurso.
  • mine: extrai os dados de propriedade fornecidos pelo proprietário de conteúdo padrão associado ao usuário autenticado.
  • none: não recupera dados de propriedade. Esse é o valor padrão.
fetchOwnershipConflicts

boolean

O parâmetro fetchOwnershipConflicts permite recuperar informações sobre conflitos de propriedade.
onBehalfOfContentOwner

string

O parâmetro onBehalfOfContentOwner identifica o proprietário do conteúdo em nome de quem o usuário está agindo. Esse parâmetro é compatível com usuários que têm contas associadas a vários proprietários de conteúdo.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Asset.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/youtubepartner

Para mais informações, consulte OAuth 2.0 Overview.