Xoá tất cả thành viên khỏi đối tượng

Hướng dẫn này giải thích cách xoá tất cả thành viên khỏi đối tượng So khớp khách hàng bằng cách gửi RemoveAllAudienceMembersRequest.

Phương thức này hữu ích nếu bạn cần xoá danh sách người dùng bằng một yêu cầu duy nhất hoặc thay thế tất cả thành viên đối tượng của một danh sách.

Xoá đối tượng

Để xoá tất cả thành viên khỏi một đối tượng, hãy gửi RemoveAllAudienceMembersRequest và bỏ qua trường removeAsOfTime. Thao tác này sẽ đặt thời gian xoá thành thời gian hiện tại, xoá tất cả thành viên hiện tại khỏi danh sách.

Thay thế tất cả thành viên

Để thay thế tất cả thành viên trong một đối tượng So khớp khách hàng mà không có danh sách người dùng nào, hãy làm theo các bước sau:

1. Ghi lại thời gian hiện tại là T.
2. Bắt đầu tải thành viên mới lên bằng cách gửi IngestAudienceMembersRequest. Bạn có thể gửi nhiều yêu cầu nhập nếu cần.

3. Chờ cho đến khi tất cả các yêu cầu nhập dữ liệu hoàn tất quá trình xử lý. Bạn có thể kiểm tra trạng thái của các yêu cầu bằng cách sử dụng Chẩn đoán.

4. Gửi một RemoveAllAudienceMembersRequest có removeAsOfTime được đặt thành dấu thời gian T được ghi lại ở Bước 1. Thao tác này chỉ xoá những thành viên được thêm trước khi bạn bắt đầu tải thành viên mới lên, chỉ giữ lại những thành viên mới được thêm.

Tạo yêu cầu

Đặt các trường sau trong phần nội dung RemoveAllAudienceMembersRequest:

destinations

Bắt buộc. Danh sách đích đến. Trường productDestinationId trong mỗi đích đến chỉ định đối tượng mà bạn muốn xoá thành viên. Hãy xem phần Định cấu hình đích đến để biết thêm thông tin.

removeAsOfTime

Không bắt buộc. Hệ thống sẽ chỉ xoá những thành viên được thêm trước thời điểm này. Để biết thông tin chi tiết về định dạng, hãy xem phần Định dạng dấu thời gian. Nếu bạn không đặt, giá trị này sẽ mặc định là thời gian hiện tại.

validateOnly

Không bắt buộc. Đặt thành true để xác thực yêu cầu mà không áp dụng các thay đổi. Khi bạn đã sẵn sàng áp dụng các thay đổi, hãy đặt thành false.

Yêu cầu mẫu

Sau đây là một yêu cầu mẫu để xoá tất cả thành viên khỏi một danh sách So khớp khách hàng.

1. Nhấp vào Open in API Explorer (Mở trong API Explorer) để mở API Explorer trong một thẻ hoặc cửa sổ mới.
2. Trong phần nội dung yêu cầu trong API Explorer, hãy thay thế từng chuỗi bắt đầu bằng REPLACE_WITH, chẳng hạn như REPLACE_WITH_OPERATING_ACCOUNT_TYPE, bằng giá trị có liên quan.
3. Nhấp vào Thực thi ở cuối trang API Explorer và hoàn tất các lời nhắc uỷ quyền để gửi yêu cầu.
4. Đặt validateOnly thành true để xác thực yêu cầu mà không áp dụng các thay đổi. Khi bạn đã sẵn sàng áp dụng các thay đổi, hãy đặt validateOnly thành false.

{
    "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
}

{
    "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
}

Gửi yêu cầu

Gửi yêu cầu đến điểm cuối removeAll.

Nếu yêu cầu thành công, phản hồi sẽ chứa một requestId mà bạn có thể dùng để theo dõi trạng thái của thao tác.

{
  "requestId": "REQUEST_ID"
}

Nếu yêu cầu không thành công, hãy kiểm tra các lỗi để xác định nguyên nhân gây ra lỗi.