Skip to content

Actualizar bloque de contenido

post

/content_blocks/update

Utiliza este punto de conexión para actualizar un bloque de contenido.

See me in Postman

Requisitos previos

Para utilizar este punto de conexión, necesitarás una clave de API con el permiso content_blocks.update.

Límite de velocidad

Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto de conexión, como se documenta en Límites de velocidad de la API.

Cuerpo de la solicitud

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
}

Parámetros de la solicitud

Parámetro Obligatorio Tipo de datos Descripción
content_block_id Obligatorio Cadena El identificador de API de tu bloque de contenido.
name Opcional Cadena Nombre del bloque de contenido. Debe tener menos de 100 caracteres.
description Opcional Cadena Descripción del bloque de contenido. Debe tener menos de 250 caracteres.
content Opcional Cadena Contenido HTML o de texto dentro de los Content Blocks.
state Opcional Cadena Elige active o draft. El valor predeterminado es active si no se especifica.
tags Opcional Matriz de cadenas Las etiquetas ya deben existir.

Ejemplo de solicitud

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"]
}'

Respuesta

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"
}

Solución de problemas

La siguiente tabla enumera los posibles errores devueltos y sus pasos asociados para la solución de problemas.

Error Solución de problemas
Content cannot be blank  
Content must be a string Asegúrate de que tu contenido está entre comillas ("").
Content must be smaller than 50kb El contenido de tu bloque de contenido debe ser inferior a 50 KB en total.
Content contains malformed liquid El Liquid proporcionado no es válido ni analizable. Vuelve a intentarlo con un Liquid válido o ponte en contacto con soporte.
Content Block cannot be referenced within itself  
Content Block description cannot be blank  
Content Block description must be a string Asegúrate de que la descripción de tu bloque de contenido está entre comillas ("").
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 Los nombres de los bloques de contenido pueden incluir cualquiera de los siguientes caracteres: las letras (mayúsculas o minúsculas) A a Z, los números 0 a 9, guiones - y guiones bajos _. No pueden contener caracteres no alfanuméricos como emojis, !, @, ~, & y otros caracteres “especiales”.
Content Block with this name already exists Prueba con otro nombre.
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 Las etiquetas deben formatearse como una matriz de cadenas, por ejemplo ["marketing", "promotional", "transactional"].
All tags must be strings Asegúrate de que tus etiquetas estén entre comillas ("").
Some tags could not be found Para añadir una etiqueta al crear un bloque de contenido, la etiqueta debe existir ya en Braze.
New Stuff!