Actualizar relación de objeto

Utiliza este endpoint para fusionar atributos en una relación de objeto existente.

Importante

Los objetos de datos están disponibles de forma general, pero tu espacio de trabajo debe estar aprovisionado para Cuentas antes de que puedas utilizar este endpoint. Para solicitar el aprovisionamiento, ve a Configuración de datos > Cuentas y completa el cuestionario. Para más detalles, consulta Habilitar Cuentas.

Requisitos previos

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

Límite de velocidad

Este endpoint pertenece al contenedor de escritura de objetos de datos, 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 para el endpoint /data_objects/objects/{type_name}/{object_id}/object_relationships.

Parámetros de solicitud

La siguiente tabla enumera y describe los parámetros del cuerpo de 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 fusiona atributos en la relación subaccount existente entre acct-123 y acct-456, y deja sin cambios los atributos que omitas.

1
2
3
4
5
6
7
8
9

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

Respuesta

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

Ejemplo de respuesta correcta

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 correcta.

Errores

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