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

En esta guía, se explica cómo quitar todos los miembros de un público de Segmentación por clientes enviando una solicitud 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.

Borrar el público

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

Reemplazar todos los miembros

Para reemplazar a todos los miembros de un público de Segmentación por clientes y, al mismo tiempo, evitar que la lista de usuarios quede vacía, sigue estos pasos:

1. Registra la hora actual como T.
2. Comienza a subir los miembros nuevos enviando una solicitud IngestAudienceMembersRequest. Puedes realizar varias solicitudes de transferencia si es necesario.

3. Espera hasta que se hayan terminado de procesar todas las solicitudes de transferencia. Puedes verificar el estado de tus solicitudes en Diagnóstico.

   Nota: Si no te preocupa que una lista de usuarios esté vacía temporalmente, puedes omitir este paso y continuar con el paso 4. De todas formas, te recomendamos que verifiques el estado de tus solicitudes de transferencia para asegurarte de que se hayan procesado correctamente.

4. Envía un RemoveAllAudienceMembersRequest con removeAsOfTime establecido en la marca de tiempo T registrada en el paso 1. Esto quita solo los miembros que se agregaron antes de que comenzaras a subir los miembros nuevos, por lo que solo quedan los miembros recién agregados.

Crea la solicitud

Configura los siguientes campos en el cuerpo de RemoveAllAudienceMembersRequest:

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 que se hayan agregado antes de ese momento. Para obtener detalles sobre el formato, consulta Formato de marca de tiempo. Si no se establece, este valor se establece de forma predeterminada en la hora actual.

validateOnly

Opcional. Establece en true para validar la solicitud sin aplicar los cambios. Cuando estés listo para aplicar los cambios, establece el valor en false.

Solicitudes de muestra

Este es un ejemplo de solicitud para quitar 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 extremo removeAll.

Si la solicitud se realiza de forma correcta, 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.