Skip to content

Mettre à jour le bloc de contenu

post

/content_blocks/update

Utilisez cet endpoint pour mettre à jour un bloc de contenu.

See me in Postman

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation content_blocks.update.

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.

Corps de la demande

1
2

Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
4
5
6
7
8

{
  "content_block_id" : (required, string) Content Block's API identifier.
  "name": (optional, string) Must be less than 100 characters,
  "description": (optional, string) The description of the Content Block. Must be less than 250 character,
  "content": (optional, string) HTML or text content within Content Block,
  "state": (optional, string) Choose `active` or `draft`. Defaults to `active` if not specified,
  "tags": (optional, array of strings) Tags must already exist
}

Paramètres de demande

Paramètre Requis Type de données Description
content_block_id Requis Chaîne de caractères L’identifiant API de votre bloc de contenu.
name Facultatif Chaîne de caractères Nom du bloc de contenu. Doit contenir moins de 100 caractères.
description Facultatif Chaîne de caractères Description du bloc de contenu. Doit contenir moins de 250 caractères.
content Facultatif Chaîne de caractères Contenu HTML ou texte dans les Content Blocks.
state Facultatif Chaîne de caractères Choisissez active ou draft. Défini par défaut sur active si non spécifié.
tags Facultatif Tableau de chaînes de caractères Les étiquettes doivent déjà exister.

Exemple de demande

1
2
3
4
5
6
7
8
9
10
11

curl --location --request POST 'https://rest.iad-01.braze.com/content_blocks/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
  "content_block_id" :"content_block_id",
  "name": "content_block",
  "description": "This is my Content Block",
  "content": "HTML or text content within block",
  "state": "draft",
  "tags": ["marketing"]
}'

Réponse

1
2
3
4
5
6

{
  "content_block_id": (string) Your newly generated block id,
  "liquid_tag": (string) The generated block tag from the Content Block name,
  "created_at": (string) The time the Content Block was created in ISO 8601,
  "message": "success"
}

Résolution des problèmes

Le tableau suivant répertorie les erreurs possibles et les étapes de résolution associées.

Erreur Résolution des problèmes
Content cannot be blank  
Content must be a string Assurez-vous que votre contenu est encadré par des guillemets ("").
Content must be smaller than 50kb Le contenu de votre bloc de contenu doit être inférieur à 50 Ko au total.
Content contains malformed liquid Le Liquid fourni n’est pas valide ou pas analysable. Réessayez avec du Liquid valide ou contactez l’assistance.
Content Block cannot be referenced within itself  
Content Block description cannot be blank  
Content Block description must be a string Assurez-vous que la description de votre bloc de contenu est encadrée par des guillemets ("").
Content Block description must be shorter than 250 characters  
Content Block name cannot be blank  
Content Block name must be shorter than 100 characters  
Content Block name can only contain alphanumeric characters Les noms de bloc de contenu peuvent comprendre l’un des caractères suivants : les lettres (majuscules ou minuscules) de A à Z, les chiffres de 0 à 9, les tirets - et les traits de soulignement _. Il ne peut pas contenir de caractères non alphanumériques comme des émojis, !, @, ~, & et d’autres caractères « spéciaux ».
Content Block with this name already exists Essayez un autre nom.
Content Block name cannot be updated for active Content Blocks  
Content Block state must be either active or draft  
Active Content Block can not be updated to Draft. Create a new Content Block.  
Tags must be an array Les étiquettes doivent être un tableau de chaînes de caractères, par exemple ["marketing", "promotional", "transactional"].
All tags must be strings Assurez-vous que vos étiquettes sont encadrées par des guillemets ("").
Some tags could not be found Pour ajouter une étiquette lors de la création d’un bloc de contenu, l’étiquette doit déjà exister dans Braze.
New Stuff!