Usuwanie wszystkich członków z listy odbiorców

Z tego przewodnika dowiesz się, jak usunąć wszystkich użytkowników z listy odbiorców kierowania na listę klientów, wysyłając żądanie RemoveAllAudienceMembersRequest.

Ta metoda jest przydatna, jeśli chcesz wyczyścić listę użytkowników za pomocą jednego żądania lub zastąpić wszystkich odbiorców na liście.

Wyczyść listę odbiorców

Aby usunąć wszystkich członków z listy odbiorców, wyślij żądanie RemoveAllAudienceMembersRequest i pomiń pole removeAsOfTime. Spowoduje to ustawienie czasu usunięcia na bieżący czas i usunięcie z listy wszystkich obecnych użytkowników.

Zastąp wszystkich członków

Aby zastąpić wszystkich członków listy odbiorców kierowania na listę klientów, unikając jednocześnie pustej listy użytkowników, wykonaj te czynności:

1. Zapisz bieżący czas jako T.
2. Rozpocznij przesyłanie nowych członków społeczności, wysyłając IngestAudienceMembersRequest. W razie potrzeby możesz wysłać kilka próśb o przetworzenie.

3. Poczekaj, aż wszystkie żądania pozyskiwania zostaną przetworzone. Stan próśb możesz sprawdzić w sekcji Diagnostyka.

4. Wyślij RemoveAllAudienceMembersRequest z parametrem removeAsOfTime ustawionym na sygnaturę czasową T zarejestrowaną w kroku 1. Spowoduje to usunięcie tylko tych członków, którzy zostali dodani przed rozpoczęciem przesyłania nowych członków, i pozostawienie tylko nowo dodanych członków.

Tworzenie żądania

Ustaw te pola w treści RemoveAllAudienceMembersRequest:

destinations

Wymagany. Lista miejsc docelowych. Pole productDestinationId w każdym miejscu docelowym określa listę odbiorców, z której chcesz usunąć użytkowników. Więcej informacji znajdziesz w artykule o konfigurowaniu miejsc docelowych.

removeAsOfTime

Opcjonalnie. Usunięci zostaną tylko użytkownicy dodani przed tym czasem. Szczegółowe informacje o formatowaniu znajdziesz w sekcji Formaty sygnatury czasowej. Jeśli nie zostanie ustawiona, domyślnie będzie to bieżąca godzina.

validateOnly

Opcjonalnie. Ustaw wartość true, aby sprawdzić poprawność żądania bez stosowania zmian. Gdy wszystko będzie gotowe do zastosowania zmian, ustaw wartość false.

Przykładowe żądania

Oto przykładowe żądanie, które usuwa wszystkich członków z listy kierowania na listę klientów.

1. Kliknij Otwórz w APIs Explorer, aby otworzyć APIs Explorer w nowej karcie lub nowym oknie.
2. W treści żądania w APIs Explorer zastąp każdy ciąg znaków zaczynający się od REPLACE_WITH, np. REPLACE_WITH_OPERATING_ACCOUNT_TYPE, odpowiednią wartością.
3. Kliknij Execute (Wykonaj) u dołu strony APIs Explorer i postępuj zgodnie z instrukcjami autoryzacji, aby wysłać żądanie.
4. Ustaw validateOnly na true, aby sprawdzić poprawność żądania bez stosowania zmian. Gdy wszystko będzie gotowe do zastosowania zmian, ustaw validateOnly na 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
}

Wysyłanie żądania

Wyślij żądanie do punktu końcowego removeAll.

Jeśli żądanie zostanie zrealizowane, odpowiedź będzie zawierać obiekt requestId, którego możesz użyć do śledzenia stanu operacji.

{
  "requestId": "REQUEST_ID"
}

Jeśli żądanie się nie powiedzie, sprawdź błędy, aby ustalić przyczynę niepowodzenia.