Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

Lista as associações de recursos do YouTube vinculadas ao recurso especificado.

Solicitação HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems/{linkedEntity.lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations

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

Parâmetros de caminho

Parâmetros
advertiserId

string (int64 format)

Obrigatório. O ID do anunciante a que a entidade vinculada pertence.
Parâmetro de união entity. A entidade a ser associada ao recurso do YouTube. entity pode ser apenas de um dos tipos a seguir:
linkedEntity.lineItemId

string (int64 format)

O ID de um item de linha.
youtubeAssetType

enum (YoutubeAssetType)

Obrigatório. O tipo de recurso do YouTube associado ao recurso.

Parâmetros de consulta

Parâmetros
Parâmetro de união entity. A entidade a ser associada ao recurso do YouTube. entity pode ser apenas de um dos tipos a seguir:
linkedEntity.adGroupId

string (int64 format)

O ID de um grupo de anúncios.
pageSize

integer

Opcional. Tamanho da página solicitada. Precisa estar entre 1 e 10000. Se não for especificado, o padrão será 100. Retorna o código de erro INVALID_ARGUMENT se um valor inválido for especificado.
pageToken

string

Opcional. Um token que identifica a página de resultados que o servidor retornará.

Normalmente, esse é o valor de nextPageToken retornado da chamada anterior ao método youtubeAssetAssociations.list. Se não for especificado, a primeira página de resultados será retornada.
orderBy

string

Opcional. Campo que classifica a lista.

Os únicos valores aceitáveis são:

  • linkedYoutubeAsset.locationAssetFilter.assetSetId,
  • linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId,
  • linkedYoutubeAsset.sitelinkAsset.assetId

A ordem de classificação padrão é crescente. Para especificar a ordem decrescente em um campo, um sufixo " desc" precisa ser adicionado ao nome dele. Exemplo: linkedYoutubeAsset.sitelinkAsset.assetId desc.

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

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/display-video

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