Method: sellers.adUnits.list

Liste les blocs d'annonces.

  • Par exemple : GET /v1/sellers/seller111/adUnits
  • Affiche une liste de blocs d'annonces et un jeton permettant de récupérer la page suivante en cas de succès.
  • Renvoie le code d'erreur PERMISSION_DENIED si l'utilisateur n'a pas accès au vendeur ou si l'ID du vendeur n'existe pas.
  • Renvoie le code d'erreur INVALID_ARGUMENT si le vendeur indique une taille de page ou un jeton de page non valides.

Requête HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Vendeur, qui possède cet ensemble de blocs d'annonces. Format: vendeurs/{seller}

Paramètres de requête

Paramètres
pageSize

integer

Le nombre maximum d'éléments à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Le nombre maximal de blocs d'annonces autorisé est de 1 000. les valeurs supérieures à 1 000 seront remplacées par 1 000. Si aucune valeur n'est spécifiée, 1 000 blocs d'annonces au maximum seront renvoyés.
pageToken

string

La valeur nextPageToken affichée par une requête "List" antérieure, le cas échéant.
filter

string

Filtre de liste. Actuellement compatible avec le filtrage par ID et état externes, à l'aide de la syntaxe suivante : "externalId = [EXTERNAL_ID]" et "state = [STATE]". Les opérateurs logiques AND et OR peuvent être utilisés pour chaîner les filtres. Impossible d'afficher les blocs d'annonces supprimés à l'aide de AD_UNIT_STATE_DELETED. Utilisez plutôt l'élément showSupprimé.
orderBy

string

Ordre par chaîne utilisé pour spécifier l'ordre de tri des résultats. Commande actuellement acceptée par updateTime ; indiquez "updateTime" pour obtenir les résultats triés par updateTime dans l'ordre croissant, ou "updateTime desc" pour l'ordre décroissant.
showDeleted

boolean

Permet d'afficher ou non les blocs d'annonces supprimés de façon réversible.

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 des données qui ont la structure suivante :

Message de réponse pour InventoryService.ListAdUnits.

Représentation JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Champs
adUnits[]

object (AdUnit)

Liste des blocs d'annonces.
nextPageToken

string

Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ pageToken lors de l'appel suivant de la méthode adUnits.list pour récupérer la page de résultats suivante.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.