Mettre à jour une relation d’objet

Utilisez cet endpoint pour fusionner des attributs sur une relation d’objet existante.

Important

Les Data Objects sont actuellement en accès anticipé. Votre espace de travail doit être activé avant que les permissions de clé API pour les Data Objects n’apparaissent dans Paramètres > Clés API.

Prérequis

Pour utiliser cet endpoint, vous avez besoin d’une clé API avec la permission data_objects.object_relationships.update.

Limite de débit

Cet endpoint fait partie du compartiment d’écriture des Data Objects avec une limite par défaut de 50 requêtes par minute.

Paramètres de chemin

Le tableau suivant répertorie et décrit les paramètres de chemin pour l’endpoint /data_objects/objects/{type_name}/{external_id}/object_relationships.

Paramètres de requête

Le tableau suivant répertorie et décrit les paramètres du corps de la requête JSON pour l’endpoint /data_objects/objects/{type_name}/{external_id}/object_relationships.

Exemple de requête

Cette section comprend un exemple de payload JSON et un exemple de requête cURL.

Exemple de payload de requête

1
2
3
4
5
6
7
{
  "rel_kind": "subaccount",
  "related_type_name": "account",
  "related_external_id": "acct-456",
  "anchor": "source",
  "attributes": {}
}

Exemple de requête cURL

Cet exemple fusionne des attributs dans la relation subaccount existante entre acct-123 et acct-456, en laissant inchangés les attributs que vous omettez.

1
2
3
4
5
6
7
8
9
10
curl --location --request PATCH 'https://rest.iad-01.braze.com/data_objects/objects/account/acct-123/object_relationships' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "rel_kind": "subaccount",
  "related_type_name": "account",
  "related_external_id": "acct-456",
  "anchor": "source",
  "attributes": {}
}'

Réponse

Cette section comprend un exemple de réponse réussie et les champs de la réponse.

Exemple de réponse réussie

Le code de statut 200 peut renvoyer le corps de réponse suivant.

1
2
3
4
5
6
7
8
9
10
11
{
  "object_relationship": {
    "rel_kind": "subaccount",
    "to_data_object": {
      "type_name": "account",
      "external_id": "acct-456",
      "attributes": { "name": "Child Account" }
    },
    "attributes": {}
  }
}

Paramètres de réponse

Le tableau suivant répertorie et décrit les champs d’une réponse réussie.

Erreurs

Le tableau suivant répertorie les erreurs courantes pour cet endpoint et comment les résoudre.