Cómo quitar a todos los miembros de un público

En esta guía, se explica cómo quitar a todos los miembros de un público de Segmentación por clientes enviando un RemoveAllAudienceMembersRequest.

Este método es útil si necesitas borrar una lista de usuarios con una sola solicitud o reemplazar a todos los miembros del público de una lista.

Borra el público

Para quitar a todos los miembros de un público, envía una RemoveAllAudienceMembersRequest y omite el campo removeAsOfTime. De forma predeterminada, la hora de eliminación se establece en la hora actual, lo que borra a todos los miembros actuales de la lista.

Reemplaza a todos los miembros

Para reemplazar a todos los miembros de un público de Segmentación por clientes y evitar una lista de usuarios vacía, sigue estos pasos:

1. Registra la hora actual como T.
2. Para comenzar a subir a los miembros nuevos al enviar un IngestAudienceMembersRequest. Si es necesario, puedes realizar varias solicitudes de ingesta.

3. Espera hasta que se terminen de procesar todas las solicitudes de ingesta. Puedes verificar el estado de tus solicitudes con Diagnóstico.

   Nota: Si no te preocupa que la lista de usuarios esté vacía temporalmente, puedes omitir este paso y pasar al paso 4. De todas formas, te recomendamos que verifiques el estado de tus solicitudes de ingesta para confirmar que se procesaron correctamente.

4. Envía un RemoveAllAudienceMembersRequest con removeAsOfTime configurado en la marca de tiempo T registrada en el paso 1. De esta forma, solo se quitarán los miembros que se agregaron antes de que comenzaras a subir a los miembros nuevos, por lo que solo quedarán los miembros agregados recientemente.

Crea la solicitud

Configura los siguientes campos en el RemoveAllAudienceMembersRequest cuerpo:

destinations

Obligatorio. Es la lista de destinos. El campo productDestinationId de cada destino especifica el público del que deseas quitar miembros. Consulta Configura destinos para obtener más información.

removeAsOfTime

Opcional. Solo se quitarán los miembros agregados antes de esta hora. Para obtener detalles sobre el formato, consulta Formato de marca de tiempo. Si no está configurado, este valor se establece de forma predeterminada en la hora actual.

validateOnly

Opcional. Establécelo en true para validar la solicitud sin aplicar los cambios. Cuando estés listo para aplicar los cambios, establécelo en false.

Solicitudes de muestra

Esta es una solicitud de muestra que quita a todos los miembros de una lista de Segmentación por clientes.

1. Haz clic en Abrir en el Explorador de APIs para abrir el Explorador de APIs en una pestaña o ventana nueva.
2. En el cuerpo de la solicitud del Explorador de APIs, reemplaza cada cadena que comience con REPLACE_WITH, como REPLACE_WITH_OPERATING_ACCOUNT_TYPE, por el valor correspondiente.
3. Haz clic en Ejecutar en la parte inferior de la página del Explorador de APIs y completa las indicaciones de autorización para enviar la solicitud.
4. Establece validateOnly en true para validar la solicitud sin aplicar los cambios. Cuando estés listo para aplicar los cambios, establece validateOnly en false.

Anunciante

Abrir en el Explorador de APIs

{
    "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
}

Socio de datos

Abrir en el Explorador de APIs

{
    "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
}

Envía la solicitud

Envía la solicitud al removeAll extremo.

Si la solicitud se realiza correctamente, la respuesta contendrá un requestId que puedes usar para hacer un seguimiento del estado de la operación.

{
  "requestId": "REQUEST_ID"
}

Si la solicitud falla, inspecciona los errores para determinar la causa de la falla.