Zum Inhalt springen

Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Datenobjekt aktualisieren

patch

/data_objects/objects/{type_name}/{object_id}

Verwenden Sie diesen Endpunkt, um Attribute mit einem bestehenden Datenobjekt zusammenzuführen.

Wichtig

Datenobjekte sind allgemein verfügbar, aber Ihr Workspace muss für Accounts freigeschaltet sein, bevor Sie diesen Endpunkt verwenden können. Um die Freischaltung anzufordern, gehen Sie zu Dateneinstellungen > Accounts und füllen Sie den Fragebogen aus. Weitere Informationen finden Sie unter Accounts aktivieren.

Voraussetzungen

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

Rate-Limit

Dieser Endpunkt gehört zum Schreib-Bucket für Datenobjekte mit einem Standardlimit von 1.000 Anfragen pro Minute.

Pfadparameter

Die folgende Tabelle listet und beschreibt die Pfadparameter für den Endpunkt /data_objects/objects/{type_name}/{object_id}.

Parameter	Erforderlich	Datentyp	Beschreibung
`type_name`	Erforderlich	String	Maschinenname des Datenobjekttyps
`object_id`	Erforderlich	String	Objektbezeichner

Anfrageparameter

Die folgende Tabelle listet und beschreibt die Parameter des JSON-Anfragekörpers für den Endpunkt /data_objects/objects/{type_name}/{object_id}.

Parameter	Erforderlich	Datentyp	Beschreibung
`attributes`	Erforderlich	Objekt	Felder der obersten Ebene, die zusammengeführt werden sollen
`display_name`	Optional	String	Anzeigename für das Objekt. Wenn der Typ ein Quellfeld für den Anzeigenamen hat, hat der Wert dieses Feldes Vorrang. Wenn nicht angegeben, wird der bestehende Anzeigename beibehalten

Beispielanfrage

Dieser Abschnitt enthält einen Beispiel-JSON-Payload und eine Beispiel-cURL-Anfrage.

Beispiel-Anfrage-Payload

{
  "attributes": {
    "credits": 750
  }
}

Beispiel-cURL-Anfrage

Dieses Beispiel aktualisiert das Attribut credits für acct-123 und lässt die übrigen Attribute des Datensatzes unverändert.

curl --location --request PATCH 'https://rest.iad-01.braze.com/data_objects/objects/account/acct-123' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{ "attributes": { "credits": 750 } }'

Antwort

Dieser Abschnitt enthält ein Beispiel für eine erfolgreiche Antwort sowie die Antwortfelder.

Beispiel für eine erfolgreiche Antwort

Der Statuscode 200 kann den folgenden Antwortkörper zurückgeben. Das Objekt attributes spiegelt das Ergebnis der Zusammenführung wider.

{
  "data_object": {
    "type_name": "account",
    "object_id": "acct-123",
    "attributes": { "name": "Acme", "credits": 750 }
  }
}

Antwortparameter

Die folgende Tabelle listet und beschreibt die Felder einer erfolgreichen Antwort.

Parameter	Erforderlich	Datentyp	Beschreibung
`data_object`	Erforderlich	Objekt	Aktualisierter Datenobjekt-Datensatz
`data_object.type_name`	Erforderlich	String	Maschinenname des Datenobjekttyps
`data_object.object_id`	Erforderlich	String	Bezeichner des Datenobjekts
`data_object.attributes`	Erforderlich	Objekt	Objektattribute nach der Zusammenführung

Fehler

Die folgende Tabelle listet häufige Fehler für diesen Endpunkt auf und beschreibt, wie Sie sie beheben.

Status	Ursache	Hinweis
`400`	Validierungsfehler	Stellen Sie sicher, dass jedes Feld in `attributes` im Typ-Schema existiert und den korrekten Datentyp verwendet.
`404`	Typ nicht gefunden oder Objekt nicht gefunden	Stellen Sie sicher, dass sowohl `type_name` als auch `object_id` im Workspace existieren.
`401`	Fehlender oder ungültiger REST-API-Schlüssel	Überprüfen Sie, ob der `Authorization`-Header `Bearer YOUR_REST_API_KEY` verwendet und ob der Schlüssel aktiv ist.
`403`	API-Schlüssel hat keine Berechtigung oder die Anfrage wird durch die Allowlist blockiert	Stellen Sie sicher, dass der Schlüssel über die Berechtigung `data_objects.update` verfügt und dass Ihre Quell-IP auf der Allowlist des Schlüssels steht, falls konfiguriert.
`429`	Rate-Limit überschritten	Versuchen Sie es nach `X-RateLimit-Reset` erneut und reduzieren Sie die Anfragehäufigkeit.

New Stuff!