오브젝트 관계 생성

이 엔드포인트를 사용하여 두 커스텀 오브젝트 간에 단방향 관계 엣지를 생성합니다.

중요

커스텀 오브젝트는 현재 얼리 액세스 중입니다. 커스텀 오브젝트 API 키 권한이 설정 > API 키에 표시되려면 워크스페이스가 활성화되어 있어야 합니다.

전제 조건

이 엔드포인트를 사용하려면 custom_objects.object_relationships.create 권한이 있는 API 키가 필요합니다.

사용량 제한

이 엔드포인트는 커스텀 오브젝트 쓰기 버킷에 포함되며, 기본값은 분당 50건의 요청으로 제한됩니다.

경로 매개변수

다음 표에는 /custom_objects/objects/{type_name}/{external_id}/object_relationships 엔드포인트의 경로 매개변수가 나열 및 설명되어 있습니다.

요청 매개변수

다음 표에는 /custom_objects/objects/{type_name}/{external_id}/object_relationships 엔드포인트의 JSON 요청 본문 매개변수가 나열 및 설명되어 있습니다.

요청 예시

이 섹션에는 샘플 JSON 페이로드와 샘플 cURL 요청이 포함되어 있습니다.

샘플 요청 페이로드

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

샘플 cURL 요청

이 예시에서는 acct-123을 subaccount으로 acct-456에 연결하며, acct-123이 관계의 소스가 됩니다.

1
2
3
4
5
6
7
8
9
10
curl --location --request POST 'https://rest.iad-01.braze.com/custom_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": {}
}'

응답

이 섹션에는 성공 응답 예시와 응답 필드가 포함되어 있습니다.

성공 응답 예시

상태 코드 201은 다음과 같은 응답 본문을 반환할 수 있습니다.

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

응답 매개변수

다음 표에는 성공 응답의 필드가 나열 및 설명되어 있습니다.

오류

다음 표에는 이 엔드포인트의 일반적인 오류와 해결 방법이 나열되어 있습니다.