사용자 관계 삭제

이 엔드포인트를 사용하여 사용자-오브젝트 관계 하나를 제거할 수 있습니다.

중요

데이터 오브젝트는 정식 출시되었지만, 이 엔드포인트를 사용하려면 먼저 워크스페이스에 계정 기능이 프로비저닝되어 있어야 합니다. 프로비저닝을 요청하려면 데이터 설정 > 계정으로 이동하여 설문지를 작성하세요. 자세한 내용은 계정 활성화를 참조하세요.

전제 조건

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

사용량 제한

이 엔드포인트는 데이터 오브젝트 쓰기 버킷에 속하며, 기본 제한은 분당 1,000회 요청입니다.

경로 매개변수

다음 표에서는 /data_objects/objects/{type_name}/{object_id}/users 엔드포인트의 경로 매개변수를 나열하고 설명합니다.

요청 매개변수

다음 표에서는 /data_objects/objects/{type_name}/{object_id}/users 엔드포인트의 JSON 요청 본문 매개변수를 나열하고 설명합니다.

참고

이 DELETE 엔드포인트는 JSON 요청 본문이 필요합니다. 사용 중인 HTTP 클라이언트가 DELETE 호출 시에도 요청 본문을 전송하는지 확인하세요.

요청 예시

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

샘플 요청 페이로드

1
2
3
4

{
  "braze_id": "507f1f77bcf86cd799439011",
  "rel_kind": "account_user"
}

샘플 cURL 요청

이 예시는 지정된 사용자와 acct-123 사이의 account_user 관계를 제거합니다. 고객 프로필과 계정 레코드는 모두 그대로 유지됩니다.

1
2
3
4
5
6
7

curl --location --request DELETE 'https://rest.iad-01.braze.com/data_objects/objects/account/acct-123/users' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "braze_id": "507f1f77bcf86cd799439011",
  "rel_kind": "account_user"
}'

응답

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

성공 응답 예시

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

1

{ "deleted": true }

응답 매개변수

다음 표에서는 성공 응답의 필드를 나열하고 설명합니다.

오류

다음 표에서는 이 엔드포인트에서 자주 발생하는 오류와 해결 방법을 나열합니다.