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 un objeto 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 todos los miembros de un público, envía un RemoveAllAudienceMembersRequest y omite el campo removeAsOfTime. De forma predeterminada, la hora de eliminación se establece en la hora actual, y se borran todos los miembros actuales de la lista.

Reemplazar 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. Comienza a subir los miembros nuevos enviando un IngestAudienceMembersRequest. Si es necesario, puedes realizar varias solicitudes de transferencia.

3. Espera hasta que finalice el procesamiento de todas las solicitudes de transferencia. Puedes verificar el estado de tus solicitudes con Diagnóstico.

4. Envía un RemoveAllAudienceMembersRequest con removeAsOfTime establecido en la marca de tiempo T registrada en el paso 1. Esta acción solo quita a los miembros que se agregaron antes de que comenzaras a subir los miembros nuevos, por lo que solo quedarán los miembros agregados recientemente.

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 agregados antes de esta hora. Para obtener detalles sobre el formato, consulta Formato de marca de tiempo. Si no se configura, el valor predeterminado es la hora actual.

validateOnly

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

Solicitudes de muestra

A continuación, se muestra una solicitud de ejemplo 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é todo listo para aplicar los cambios, configura validateOnly en 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
}

Envía la solicitud

Envía la solicitud al extremo removeAll.

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.