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 członków listy odbiorców.

Wyczyść listę odbiorców

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

Zastąp wszystkich członków

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

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

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 zarejestrowaną w kroku 1. Spowoduje to usunięcie tylko tych użytkowników, którzy zostali dodani przed rozpoczęciem przesyłania nowych użytkowników. Pozostaną tylko nowo dodani użytkownicy.

Tworzenie żądania

Ustaw te pola w treści RemoveAllAudienceMembersRequest:

destinations

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

removeAsOfTime

Opcjonalnie. Usunięci zostaną tylko użytkownicy dodani przed tym czasem. Szczegółowe informacje o formatowaniu znajdziesz w sekcji Format sygnatury czasowej. Jeśli nie jest ustawiona, domyślnie przyjmuje wartość bieżącego czasu.

validateOnly

Opcjonalnie. Ustaw na true, aby zweryfikować prośbę bez stosowania zmian. Gdy zechcesz zastosować zmiany, 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 odpowiedz na pytania dotyczące 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.