Zum Inhalt springen

Content-Block-Informationen anzeigen

get

/content_blocks/info

Verwenden Sie diesen Endpunkt, um Informationen zu Ihren bestehenden Content Blocks abzurufen.

Voraussetzungen

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

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.

Anfrageparameter

Parameter Erforderlich Datentyp Beschreibung
content_block_id Erforderlich String Der Content-Block-Bezeichner.

Sie finden diesen, indem Sie entweder die Content-Block-Informationen über einen API-Aufruf auflisten oder die Seite API-Schlüssel aufrufen, dann nach unten scrollen und nach Ihrem Content-Block-API-Bezeichner suchen.
include_inclusion_data Optional Boolescher Wert Wenn auf true gesetzt, gibt die API den API-Bezeichner der Nachrichtenvariante von Campaigns und Canvases zurück, in denen dieser Content-Block enthalten ist, um ihn in nachfolgenden Aufrufen zu verwenden. Die Ergebnisse schließen archivierte oder gelöschte Campaigns oder Canvases aus.

Beispielanfrage

curl --location -g --request GET 'https://rest.iad-01.braze.com/content_blocks/info?content_block_id={{content_block_id}}&include_inclusion_data=false' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Antwort

{
  "content_block_id": (string) the Content Block identifier,
  "name": (string) the name of the Content Block,
  "content": (string) the content in the Content Block,
  "description": (string) the Content Block description,
  "content_type": (string) the content type, html or text,
  "tags": (array) An array of tags formatted as strings,
  "created_at": (string) The time the Content Block was created in ISO 8601,
  "last_edited": (string) The time the Content Block was last edited in ISO 8601,
  "inclusion_count" : (integer) the inclusion count,
  "inclusion_data": (array) the inclusion data,
  "message": "success"
}

Fehlerbehebung

Die folgende Tabelle listet mögliche zurückgegebene Fehler und die zugehörigen Schritte zur Fehlerbehebung auf.

Fehler Fehlerbehebung
Content Block ID cannot be blank Stellen Sie sicher, dass ein Content-Block in Ihrer Anfrage aufgeführt und in Anführungszeichen ("") eingeschlossen ist.
Content Block ID is invalid for this workspace Dieser Content-Block existiert nicht oder befindet sich in einem anderen Unternehmenskonto oder Workspace.
Content Block has been deleted—content not available Dieser Content-Block wurde gelöscht, auch wenn er zuvor existiert hat.
Include Inclusion Data—error Dieser Parameter akzeptiert nur boolesche Werte (true oder false). Stellen Sie sicher, dass der Wert für include_inclusion_data nicht in Anführungszeichen ("") eingeschlossen ist, da der Wert sonst als String gesendet wird. Weitere Details finden Sie unter Anfrageparameter.
New Stuff!