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

Z tego przewodnika dowiesz się, jak usunąć wszystkich członków z grupy odbiorców z 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 grupy odbiorców na liście.

Wyczyść grupę odbiorców

Aby usunąć wszystkich członków z grupy odbiorców, wyślij RemoveAllAudienceMembersRequest i pomiń pole removeAsOfTime. Domyślnie czas usunięcia jest ustawiony na bieżący czas, co powoduje usunięcie wszystkich obecnych członków z listy.

Zastąp wszystkich członków

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

  1. Zapisz bieżący czas jako T.
  2. Zacznij przesyłać nowych członków przez wysłanie IngestAudienceMembersRequest. W razie potrzeby możesz wysłać kilka żądań.

  3. Poczekaj, aż wszystkie żądania zostaną przetworzone. Stan żądań możesz sprawdzić za pomocą narzędzia Diagnostyka.

  4. Wyślij RemoveAllAudienceMembersRequest z removeAsOfTime ustawionym na sygnaturę czasową T zapisaną w kroku 1. Spowoduje to usunięcie tylko tych członków, którzy zostali dodani zanim zaczniesz przesyłać nowych członków, pozostawiając tylko nowo dodanych członków.

Utwórz żądanie

Ustaw te pola w treści RemoveAllAudienceMembersRequest:

destinations
Wymagane. Lista miejsc docelowych. Pole productDestinationId w każdym miejscu docelowym określa grupę odbiorców, z której chcesz usunąć członków. Więcej informacji znajdziesz w artykule Konfigurowanie miejsc docelowych.
removeAsOfTime
Opcjonalne. Usunięci zostaną tylko członkowie dodani przed tym czasem. Szczegółowe informacje o formatowaniu znajdziesz w artykule Format sygnatury czasowej. Jeśli to pole nie jest ustawione, jego wartość domyślna to bieżący czas.
validateOnly
Opcjonalne. Ustaw wartość true, aby zweryfikować żądanie bez wprowadzania zmian. Gdy będziesz gotowy(-a) do wprowadzenia 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 narzędziu API Explorer , aby otworzyć narzędzie API Explorer w nowej karcie lub oknie.
  2. W treści żądania w narzędziu API 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. U dołu strony narzędzia API Explorer kliknij Wykonaj i wykonaj instrukcje autoryzacji, aby wysłać żądanie.
  4. Ustaw wartość validateOnly na true, aby zweryfikować żądanie bez wprowadzania zmian. Gdy będziesz gotowy(-a) do wprowadzenia zmian, ustaw wartość validateOnly na false.

Reklamodawca

Otwórz w narzędziu API Explorer 
{
    "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
}

Dostawca danych

Otwórz w narzędziu API Explorer 
{
    "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
}

Wyślij żądanie

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

Jeśli żądanie się powiedzie, odpowiedź będzie zawierać 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.

Wstecz
Sprawdzanie wyników przesyłania