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 rất hữu ích nếu bạn cần xoá một 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 trong phân khúc đố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 một yêu cầu RemoveAllAudienceMembersRequest và bỏ qua trường removeAsOfTime. Thao tác này sẽ đặt thời gian xoá mặc định là 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 đối tượng So khớp khách hàng mà không để danh sách người dùng trống, hãy làm theo các bước sau:

1. Ghi lại thời gian hiện tại dưới dạng 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ả yêu cầu nhập dữ liệu được xử lý xong. Bạn có thể kiểm tra trạng thái của yêu cầu bằng cách sử dụng công cụ Chẩn đoán.

4. Gửi RemoveAllAudienceMembersRequest có removeAsOfTime được đặt thành dấu thời gian T được ghi lại trong 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 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. Chỉ những thành viên được thêm trước thời điểm này mới bị xoá. Để 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

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

1. Nhấp vào Open in API Explorer (Mở trong Trình khám phá API) để mở Trình khám phá API 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 Execute (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 lỗi để xác định nguyên nhân gây ra lỗi.