Remover todos os membros de um público-alvo

Neste guia, explicamos 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 horário atual, removendo todos os membros atuais da lista.

Substituir todos os membros

Para substituir todos os membros em um público-alvo segmentado por lista de clientes sem deixar a 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. Você pode fazer várias solicitações de ingestão, se necessário.

3. Aguarde até que todas as solicitações de ingestão tenham sido processadas. Você pode verificar o status das suas solicitações usando o 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 verificar o status das suas solicitações de ingestão para confirmar se elas foram processadas.

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

Crie a solicitação

Defina os seguintes campos no corpo de 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 detalhes sobre a formatação, consulte Formato de carimbo de data/hora. Se não for definido, esse valor será padronizado para o horário 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

Veja um exemplo de solicitação que remove todos os membros de um segmento de público-alvo 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 APIs 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 APIs Explorer e conclua as solicitações 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 APIs 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 APIs 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 rastrear o status da operação.

{
  "requestId": "REQUEST_ID"
}

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