Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, ouvrez un ticket sur GitHub.
Exporter la liste des campagnes
get
/campaigns/list
Utilisez cet endpoint pour exporter une liste de campagnes, chacune incluant son nom, l’identifiant API de la campagne, s’il s’agit d’une campagne API, et les étiquettes associées à la campagne.
Les campagnes sont renvoyées par groupes de 100, triées par date de création (des plus anciennes aux plus récentes par défaut).
Conditions préalables
Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation campaigns.list.
Limite de débit
La limite de débit par défaut de Braze de 250 000 requêtes par heure s’applique à cet endpoint, comme documenté dans Limites de débit de l’API.
Paramètres de requête
| Paramètre | Requis | Type de données | Description |
|---|---|---|---|
page |
Facultatif | Entier | La page de campagnes à renvoyer, par défaut 0 (renvoie le premier ensemble pouvant contenir jusqu’à 100 éléments). |
include_archived |
Facultatif | Valeur booléenne | Indique s’il faut inclure ou non les campagnes archivées, par défaut sur false. |
sort_direction |
Facultatif | Chaîne de caractères | - Trier par date de création de la plus récente à la plus ancienne : indiquer la valeur desc.- Trier par date de création de la plus ancienne à la plus récente : indiquer la valeur asc. Si sort_direction n’est pas inclus, l’ordre par défaut est de la plus ancienne à la plus récente. |
last_edit.time[gt] |
Facultatif | Date | Filtre les résultats et renvoie uniquement les campagnes modifiées après l’heure indiquée jusqu’à maintenant. Le format est yyyy-MM-DDTHH:mm:ss. |
Exemple de requête
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/campaigns/list?page=0&include_archived=false&sort_direction=desc&last_edit.time[gt]=2020-06-28T23:59:59-5:00' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Réponse
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"message": (required, string) the status of the export, returns 'success' when completed without errors,
"campaigns" : [
{
"id" : (string) the Campaign API identifier,
"last_edited": (ISO 8601 string) the last edited time for the message
"name" : (string) the campaign name,
"is_api_campaign" : (boolean) whether the campaign is an API campaign,
"tags" : (array) the tag names associated with the campaign formatted as strings
},
...
]
}
Conseil:
Pour obtenir de l’aide sur les exportations CSV et API, consultez la section Résolution des problèmes d’exportation.
New Stuff!