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

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

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

Wyczyść listę odbiorców

Aby usunąć wszystkich członków z listy odbiorców, wyślij RemoveAllAudienceMembersRequest i pomijaj pole removeAsOfTime. Domyślnie czas usunięcia zostanie ustawiony na bieżący czas, a wszyscy obecni członkowie zostaną usunięci z listy.

Zastąp wszystkich członków

Aby zastąpić wszystkich członków listy odbiorców z kierowania na listę klientów i uniknąć pustej listy użytkowników:

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

3. Poczekaj, aż wszystkie żądania dotyczące przesyłania danych zostaną przetworzone. Stan próśb możesz sprawdzić w sekcji Diagnostyka.

4. Wyślij RemoveAllAudienceMembersRequest z parametrem removeAsOfTime ustawionym na sygnaturę czasową T zapisaną w kroku 1. Spowoduje to usunięcie tylko tych wspierających, którzy zostali dodani zanim rozpoczęto przesyłanie nowych wspierających. Pozostaną tylko nowo dodani wspierający.

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 Konfigurowanie miejsc docelowych.

removeAsOfTime

Opcjonalnie. Usunięte zostaną tylko osoby dodane przed tym czasem. Szczegółowe informacje o formatowaniu znajdziesz w sekcji Format sygnatury czasowej. Jeśli nie jest ustawiona, domyślnie przyjmuje się bieżący czas.

validateOnly

Opcjonalnie. Ustaw wartość true, aby zweryfikować prośbę bez stosowania zmian. Gdy wszystko będzie gotowe, ustaw przełącznik w pozycji false.

Przykładowe żądania

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

1. Kliknij Otwórz w API Explorer, aby otworzyć API Explorer w nowej karcie lub oknie.
2. W treści żądania w Eksploratorze interfejsu API zastąp każdy ciąg znaków zaczynający się od REPLACE_WITH, np. REPLACE_WITH_OPERATING_ACCOUNT_TYPE, odpowiednią wartością.
3. U dołu strony narzędzia APIs Explorer kliknij Wykonaj i wykonaj instrukcje autoryzacji, aby wysłać żądanie.
4. Ustaw wartość validateOnly na true, aby zweryfikować prośbę bez stosowania zmian. Gdy zechcesz zastosować zmiany, 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 się powiedzie, 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 określić przyczynę niepowodzenia.