Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

잠재고객에서 모든 구성원 삭제하기

이 가이드에서는 RemoveAllAudienceMembersRequest을 전송하여 고객 매치 타겟팅 잠재고객에서 모든 구성원을 삭제하는 방법을 설명합니다.

이 메서드는 단일 요청으로 사용자 목록을 지우거나 목록의 모든 잠재고객 구성원을 대체해야 하는 경우에 유용합니다.

잠재고객 지우기

잠재고객에서 모든 구성원을 삭제하려면 RemoveAllAudienceMembersRequest를 전송하고 removeAsOfTime 필드를 생략합니다. 이렇게 하면 삭제 시간이 현재 시간으로 기본 설정되어 목록에서 현재 회원이 모두 삭제됩니다.

모든 구성원 바꾸기

빈 사용자 목록을 방지하면서 고객 매치 타겟팅 잠재고객의 모든 회원을 바꾸려면 다음 단계를 따르세요.

현재 시간을 T로 기록합니다.
IngestAudienceMembersRequest를 전송하여 새 회원의 업로드를 시작합니다. 필요한 경우 여러 인제션 요청을 할 수 있습니다.
모든 수집 요청의 처리가 완료될 때까지 기다립니다. 진단을 사용하여 요청 상태를 확인할 수 있습니다.

참고: 일시적으로 비어 있는 사용자 목록이 문제가 되지 않는다면 이 단계를 건너뛰고 4단계로 이동하세요. 하지만 처리 요청이 성공적으로 처리되었는지 확인하기 위해 요청 상태를 확인하는 것이 좋습니다.
removeAsOfTime이 1단계에서 기록된 타임스탬프 T로 설정된 RemoveAllAudienceMembersRequest를 전송합니다. 이렇게 하면 새 구성원 업로드를 시작하기 전에 추가된 구성원만 삭제되고 새로 추가된 구성원만 남습니다.

요청 구성

RemoveAllAudienceMembersRequest 본문에서 다음 필드를 설정합니다.

destinations: 필수사항. 대상 목록입니다. 각 대상의 productDestinationId 필드는 구성원을 삭제할 잠재고객을 지정합니다. 자세한 내용은 대상 구성을 참고하세요.
removeAsOfTime: 선택사항입니다. 이 시간 이전에 추가된 회원만 삭제됩니다. 형식 지정에 대한 자세한 내용은 타임스탬프 형식을 참고하세요. 설정하지 않으면 이 값은 기본적으로 현재 시간입니다.
validateOnly: 선택사항입니다. 변경사항을 적용하지 않고 요청을 검증하려면 true로 설정합니다. 변경사항을 적용할 준비가 되면 false로 설정합니다.

샘플 요청

다음은 고객 매치 타겟팅 목록에서 모든 구성원을 삭제하는 샘플 요청입니다.

API 탐색기에서 열기를 클릭하여 새 탭이나 창에서 API 탐색기를 엽니다.
API 탐색기의 요청 본문에서 REPLACE_WITH로 시작하는 각 문자열(예: REPLACE_WITH_OPERATING_ACCOUNT_TYPE)을 관련 값으로 바꿉니다.
API 탐색기 페이지 하단에 있는 실행을 클릭하고 승인 프롬프트를 완료하여 요청을 보냅니다.
validateOnly을 true로 설정하여 변경사항을 적용하지 않고 요청을 검증합니다. 변경사항을 적용할 준비가 되면 validateOnly을 false로 설정합니다.

광고주

API 탐색기에서 열기

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "LOGIN_ACCOUNT_TYPE",
                "accountId": "LOGIN_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

데이터 파트너

API 탐색기에서 열기

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "DATA_PARTNER",
                "accountId": "DATA_PARTNER_ACCOUNT_ID"
            },
            "linkedAccount": {
                "accountType": "LINKED_ACCOUNT_TYPE",
                "accountId": "LINKED_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

요청 전송

removeAll 엔드포인트에 요청을 보냅니다.

요청이 성공하면 응답에 requestId가 포함되며, 이를 사용하여 작업 상태를 추적할 수 있습니다.

{
  "requestId": "REQUEST_ID"
}

요청이 실패하면 오류를 검사하여 실패 원인을 파악합니다.

업로드 결과 확인