Remover todos os membros de um público-alvo

Este guia explica como remover todos os membros de um público-alvo segmentado por lista de clientes enviando um RemoveAllAudienceMembersRequest.

Esse método é útil se você precisar limpar uma lista de usuários com uma única solicitação ou substituir todos os membros do público-alvo de uma lista.

Limpar o público-alvo

Para remover todos os membros de um público-alvo, envie um RemoveAllAudienceMembersRequest e omita o campo removeAsOfTime. Isso define o horário de remoção como o atual, limpando todos os membros atuais da lista.

Substituir todos os membros

Para substituir todos os membros de um público-alvo segmentado por lista de clientes e evitar uma lista de usuários vazia, siga estas etapas:

1. Registre o horário atual como T.
2. Comece a fazer upload dos novos membros enviando um IngestAudienceMembersRequest. É possível fazer várias solicitações de ingestão, se necessário.

3. Aguarde até que todas as solicitações de ingestão terminem o processamento. Você pode verificar o status das suas solicitações usando Diagnóstico.

   Observação: se uma lista de usuários temporariamente vazia não for um problema, pule esta etapa e vá para a etapa 4. Ainda recomendamos que você verifique o status das suas solicitações de ingestão para confirmar se elas foram processadas corretamente.

4. Envie um RemoveAllAudienceMembersRequest com removeAsOfTime definido como o carimbo de data/hora T registrado na etapa 1. Isso remove apenas os membros adicionados antes de você começar a fazer upload dos novos membros, deixando apenas os que foram adicionados recentemente.

Crie a solicitação

Defina os seguintes campos no corpo RemoveAllAudienceMembersRequest:

destinations

Obrigatório. A lista de destinos. O campo productDestinationId em cada destino especifica o público-alvo de que você quer remover membros. Consulte Configurar destinos para mais informações.

removeAsOfTime

Opcional. Somente os membros adicionados antes desse horário serão removidos. Para mais detalhes sobre a formatação, consulte Formato de carimbo de data/hora. Se não for definido, o valor padrão será a hora atual.

validateOnly

Opcional. Defina como true para validar a solicitação sem aplicar as mudanças. Quando estiver tudo pronto para aplicar as mudanças, defina como false.

Exemplos de solicitação

Confira um exemplo de solicitação que remove todos os membros de uma lista de público-alvo segmentado por lista de clientes.

1. Clique em Abrir no APIs Explorer para abrir o APIs Explorer em uma nova guia ou janela.
2. No corpo da solicitação no API Explorer, substitua cada string que começa com REPLACE_WITH, como REPLACE_WITH_OPERATING_ACCOUNT_TYPE, pelo valor relevante.
3. Clique em Executar na parte de baixo da página do API Explorer e conclua os prompts de autorização para enviar a solicitação.
4. Defina validateOnly como true para validar a solicitação sem aplicar as mudanças. Quando estiver tudo pronto para aplicar as mudanças, defina validateOnly como false.

Advertiser

Abrir no 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
}

Parceiro de dados

Abrir no 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
}

Enviar a solicitação

Envie a solicitação para o endpoint removeAll.

Se a solicitação for bem-sucedida, a resposta vai conter um requestId que pode ser usado para acompanhar o status da operação.

{
  "requestId": "REQUEST_ID"
}

Se a solicitação falhar, inspecione os erros para determinar a causa da falha.