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

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

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

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

잠재고객 지우기

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

모든 회원 바꾸기

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

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

참고: 일시적으로 빈 사용자 목록이 문제가 되지 않는다면 이 단계를 건너뛰고 4단계로 이동하세요. 수집 요청이 성공적으로 처리되었는지 확인하기 위해 상태를 확인하는 것이 좋습니다.
1단계에서 기록한 타임스탬프 T 로 설정된 removeAsOfTime으로 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"
}

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

업로드 결과 확인