Reemplazar relación de objeto

Usa este endpoint para crear o reemplazar una relación de objeto.

Importante

Data Objects está disponible de forma general, pero tu espacio de trabajo debe estar aprovisionado para Accounts antes de que puedas usar este endpoint. Para solicitar el aprovisionamiento, ve a Configuración de datos > Accounts y completa el cuestionario. Para más detalles, consulta Habilitar Accounts.

Requisitos previos

Para usar este endpoint, necesitas una clave de API con el permiso data_objects.object_relationships.update.

Límite de velocidad

Este endpoint se encuentra en el contenedor de escritura de Data Objects, con un límite predeterminado de 1000 solicitudes por minuto.

Parámetros de ruta

La siguiente tabla enumera y describe los parámetros de ruta del endpoint /data_objects/objects/{type_name}/{object_id}/object_relationships.

Parámetros de la solicitud

La siguiente tabla enumera y describe los parámetros del cuerpo de la solicitud JSON para el endpoint /data_objects/objects/{type_name}/{object_id}/object_relationships.

Ejemplo de solicitud

Esta sección incluye una carga útil JSON de ejemplo y una solicitud cURL de ejemplo.

Carga útil de solicitud de ejemplo

1
2
3
4
5
6

{
  "rel_kind": "subaccount",
  "related_type_name": "account",
  "related_object_id": "acct-456",
  "attributes": {}
}

Solicitud cURL de ejemplo

Este ejemplo reemplaza la relación subaccount entre acct-123 y acct-456, y sobrescribe cualquier atributo almacenado previamente en ella.

1
2
3
4
5
6
7
8
9

curl --location --request PUT '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_object_id": "acct-456",
  "attributes": {}
}'

Respuesta

Esta sección incluye un ejemplo de respuesta exitosa y los campos de la respuesta.

Ejemplo de respuesta exitosa

El código de estado 200 podría devolver el siguiente cuerpo de respuesta.

1
2
3
4
5
6
7
8
9
10
11

{
  "object_relationship": {
    "rel_kind": "subaccount",
    "to_data_object": {
      "type_name": "account",
      "object_id": "acct-456",
      "attributes": { "name": "Child Account" }
    },
    "attributes": {}
  }
}

Parámetros de respuesta

La siguiente tabla enumera y describe los campos de una respuesta exitosa.

Errores

La siguiente tabla enumera los errores comunes de este endpoint y cómo resolverlos.