- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Liste les groupes d'annonces.
Requête HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
advertiserId |
Obligatoire. Référence de l'annonceur auquel appartiennent les groupes d'annonces. |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
Facultatif. Taille de la page demandée. La valeur doit être comprise entre |
pageToken |
Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer. En général, il s'agit de la valeur de |
orderBy |
Facultatif. Champ selon lequel la liste doit être triée. Les valeurs acceptées sont les suivantes :
Par défaut, l'ordre de tri est croissant. Pour indiquer l'ordre décroissant d'un champ, ajoutez un suffixe "desc". doit être ajouté au nom du champ. Exemple : |
filter |
Facultatif. Permet un filtrage par champs de groupe d'annonces personnalisés. Syntaxe compatible:
Propriétés compatibles:
Exemples :
La longueur de ce champ ne doit pas dépasser 500 caractères. Pour en savoir plus, consultez notre guide sur le filtrage des requêtes |
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 présentant la structure suivante :
Représentation JSON |
---|
{
"adGroups": [
{
object ( |
Champs | |
---|---|
adGroups[] |
Liste des groupes d'annonces. Cette liste sera absente si elle est vide. |
nextPageToken |
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/display-video
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.