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
Nous appliquons la limitation du débit Braze par défaut de 250 000 requêtes par heure à cet endpoint, comme documenté dans Limites de débit de l’API.
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. |
Modifier cette page sur GitHub