Method: assets.list

Recupera uma lista de recursos com base nos metadados do recurso. O método pode recuperar todos os recursos ou apenas os recursos pertencentes ao proprietário do conteúdo.

Observe que, nos casos em que os recursos duplicados foram mesclados, a resposta da API só contém o recurso sintetizado. (ela não contém os recursos constituintes que foram combinados com o recurso sintetizado).

Solicitação HTTP

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

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

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 descontinuado matchPolicy 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 serão 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: recupera 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.
id

string

O parâmetro id especifica uma lista separada por vírgulas de IDs de recursos do YouTube que identificam os recursos que você quer recuperar. Conforme observado na descrição do método, se você tentar recuperar um recurso que o YouTube identificou como duplicado e mesclou com outro, a resposta da API só vai retornar o recurso sintetizado. Nesse caso, a propriedade aliasId no recurso asset especifica uma lista de outros IDs de recursos que podem ser usados para identificar esse recurso.

Observe também que a resposta da API não contém duplicações. Portanto, se a solicitação identificar três IDs de recurso e todos eles forem mesclados em um único recurso, a resposta da API vai identificar um recurso correspondente.
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

Uma lista paginada de recursos asset retornados em resposta à solicitação assets.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "items": [
    {
      object (Asset)
    }
  ]
}
Campos
kind

string

O tipo de resposta da API. Para essa operação, o valor é youtubePartner#assetList.
items[]

object (Asset)

Uma lista de recursos asset que correspondem aos critérios da solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

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