- 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 campagnes d'un annonceur.
L'ordre est défini par le paramètre orderBy
. Si aucune valeur filter
par entityStatus
n'est spécifiée, les campagnes avec ENTITY_STATUS_ARCHIVED
ne seront pas incluses dans les résultats.
Requête HTTP
GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/campaigns
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
advertiserId |
ID de l'annonceur pour lequel répertorier les campagnes. |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
Taille de la page demandée. Doit être compris entre |
pageToken |
Jeton identifiant une page de résultats que le serveur doit renvoyer. En règle générale, il s'agit de la valeur de |
orderBy |
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 spécifier l'ordre décroissant d'un champ, vous devez ajouter le suffixe "desc" au nom du champ. Exemple : |
filter |
Permet de filtrer par champs de campagne. Syntaxe acceptée:
Champs pris en charge:
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 |
---|
{
"campaigns": [
{
object ( |
Champs | |
---|---|
campaigns[] |
Liste des campagnes. Cette liste est 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
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
Pour en savoir plus, consultez la présentation d'OAuth 2.0.