Skip to content

Content-Block aktualisieren

post

/content_blocks/update

Verwenden Sie diesen Endpunkt, um einen Content-Block zu aktualisieren.

See me in Postman

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung content_blocks.update.

Rate-Limit

Wir wenden auf diesen Endpunkt das standardmäßige Braze-Rate-Limit von 250.000 Anfragen pro Stunde an, wie in API-Rate-Limits dokumentiert.

Anfragetext

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
}

Anfrageparameter

Parameter Erforderlich Datentyp Beschreibung
content_block_id Erforderlich String Der API-Bezeichner Ihres Content-Blocks.
name Optional String Name des Content-Blocks. Muss weniger als 100 Zeichen umfassen.
description Optional String Beschreibung des Content-Blocks. Muss weniger als 250 Zeichen umfassen.
content Optional String HTML- oder Textinhalte innerhalb von Content Blocks.
state Optional String Wählen Sie active oder draft. Der Standardwert ist active, wenn nichts angegeben wird.
tags Optional String-Array Tags müssen bereits existieren.

Beispielanfrage

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

Antwort

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

Fehlerbehebung

In der folgenden Tabelle finden Sie eine Liste möglicher zurückgegebener Fehler und die entsprechenden Schritte zur Fehlerbehebung.

Fehler Fehlerbehebung
Content cannot be blank  
Content must be a string Achten Sie darauf, dass Ihr Inhalt in Anführungszeichen ("") eingeschlossen ist.
Content must be smaller than 50kb Der Inhalt Ihres Content-Blocks muss insgesamt weniger als 50 KB groß sein.
Content contains malformed liquid Das angegebene Liquid ist ungültig oder nicht parsbar. Bitte versuchen Sie es erneut mit gültigem Liquid oder wenden Sie sich an den Support.
Content Block cannot be referenced within itself  
Content Block description cannot be blank  
Content Block description must be a string Achten Sie darauf, dass die Beschreibung Ihres Content-Blocks in Anführungszeichen ("") eingeschlossen ist.
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 Content-Block-Namen können jedes der folgenden Zeichen enthalten: die Buchstaben (groß- oder kleingeschrieben) A bis Z, die Zahlen 0 bis 9, Bindestriche - und Unterstriche _. Er kann keine nicht-alphanumerischen Zeichen wie Emojis, !, @, ~, & und andere „Sonderzeichen“ enthalten.
Content Block with this name already exists Versuchen Sie einen anderen Namen.
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 Tags müssen als String-Array formatiert werden, zum Beispiel ["marketing", "promotional", "transactional"].
All tags must be strings Achten Sie darauf, dass Ihre Tags in Anführungszeichen ("") eingeschlossen sind.
Some tags could not be found Um bei der Erstellung eines Content-Blocks ein Tag hinzuzufügen, muss das Tag bereits in Braze vorhanden sein.
New Stuff!