Mettre à jour les modèles d’e-mail existants
/templates/email/update
Utilisez cet endpoint pour mettre à jour des modèles d’e-mail sur le tableau de bord de Braze.
Vous pouvez accéder au site email_template_id
d’un modèle d’e-mail en naviguant jusqu’à lui sur la page Modèles et médias. L’endpoint Créer un modèle d’e-mail renvoie également une référence email_template_id
.
Tous les champs autres que l’email_template_id
sont facultatifs, mais vous devez spécifier au moins un champ à mettre à jour.
Conditions préalables
Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation templates.email.update
.
Limite de débit
We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.
Corps de la demande
1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
1
2
3
4
5
6
7
8
9
10
{
"email_template_id": (required, string) Your email template's API Identifier,
"template_name": (optional, string) The name of your email template,
"subject": (optional, string) The email template subject line,
"body": (optional, string) The email template body that may include HTML,
"plaintext_body": (optional, string) A plaintext version of the email template body,
"preheader": (optional, string) The email preheader used to generate previews in some clients,
"tags": (optional, array of Strings) Tags must already exist,
"should_inline_css": (optional, Boolean) If `true`, the `inline_css` feature will be applied to the template.
}
Paramètres de demande
Paramètre | Requis | Type de données | Description |
---|---|---|---|
email_template_id |
Requis | Chaîne de caractères | L’identifiant API de votre modèle d’e-mail. |
template_name |
Facultatif | Chaîne de caractères | Nom de votre modèle d’e-mail |
subject |
Facultatif | Chaîne de caractères | Ligne Objet du modèle d’e-mail. |
body |
Facultatif | Chaîne de caractères | Corps du modèle d’e-mail pouvant inclure du HTML. |
plaintext_body |
Facultatif | Chaîne de caractères | Une version en texte brut du corps du modèle d’e-mail. |
preheader |
Facultatif | Chaîne de caractères | Accroche d’e-mail utilisée pour générer des aperçus chez certains clients. |
tags |
Facultatif | Chaîne de caractères | Les étiquettes doivent déjà exister. |
should_inline_css |
Facultatif | Valeur booléenne | Active ou désactive la fonction inline_css par modèle. Si non renseigné, Braze utilisera le paramètre par défaut de l’AppGroup. true ou false est attendu. |
Exemple de demande
1
2
3
4
5
6
7
8
9
10
11
12
curl --location --request POST 'https://rest.iad-01.braze.com/templates/email/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
"email_template_id": "email_template_id",
"template_name": "Weekly Newsletter",
"subject": "This Week'\''s Styles",
"body": "Check out this week'\''s digital lookbook to inspire your outfits. Take a look at https://www.braze.com/",
"plaintext_body": "This is the updated text within my email body and here is a link to https://www.braze.com/.",
"preheader": "We want you to have the best looks this summer",
"tags": ["Tag1", "Tag2"]
}'
Résolution des problèmes
Le tableau suivant répertorie les erreurs renvoyées possibles et les étapes de résolution des problèmes associées, le cas échéant.
Erreur | Résolution des problèmes |
---|---|
Le nom du modèle est obligatoire | Saisissez un nom de modèle. |
Les balises doivent être un tableau | Les balises doivent être un tableau de chaînes de caractères, par exemple ["marketing", "promotional", "transactional"] . |
Toutes les balises doivent être des chaînes de caractères | Assurez-vous que vos balises sont comprises entre des guillemets ("" ). |
Certaines balises sont introuvables | Pour ajouter une balise lors de la création d’un modèle d’e-mail, la balise doit déjà exister dans Braze. |
Valeur non valide pour should_inline_css . true ou false était attendu |
Ce paramètre accepte uniquement les valeurs booléennes (vrai ou faux). Assurez-vous que la valeur de should_inline_css n’est pas comprise entre des guillemets ("" ), sinon la valeur est envoyée comme chaîne de caractères. |