Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

Liste les associations d'éléments YouTube liées à la ressource donnée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
advertiserId

string (int64 format)

Obligatoire. ID de l'annonceur auquel appartient l'entité associée.
Paramètre d'union entity. Entité à associer à l'élément YouTube. entity ne peut être qu'un des éléments suivants :
linkedEntity.lineItemId

string (int64 format)

Identifiant d'un élément de ligne.
youtubeAssetType

enum (YoutubeAssetType)

Obligatoire. Type d'élément YouTube associé à la ressource.

Paramètres de requête

Paramètres
Paramètre d'union entity. Entité à associer à l'élément YouTube. entity ne peut être qu'un des éléments suivants :
linkedEntity.adGroupId

string (int64 format)

ID d'un groupe d'annonces.
pageSize

integer

Facultatif. Taille de la page demandée. La valeur doit être comprise entre 1 et 10000. Si aucune valeur n'est spécifiée, la valeur par défaut est 100. Renvoie le code d'erreur INVALID_ARGUMENT si une valeur non valide est spécifiée.
pageToken

string

Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer.

Il s'agit généralement de la valeur de nextPageToken renvoyée par l'appel précédent à la méthode youtubeAssetAssociations.list. Si cette option n'est pas spécifiée, la première page de résultats est renvoyée.
orderBy

string

Facultatif. Champ selon lequel trier la liste.

Les seules valeurs acceptées sont les suivantes :

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

L'ordre de tri par défaut est croissant. Pour spécifier un ordre décroissant pour un champ, le suffixe " desc" doit être ajouté au nom du champ. Exemple : linkedYoutubeAsset.sitelinkAsset.assetId desc.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de ListYoutubeAssetAssociationsResponse.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.