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 uma 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, evitando uma lista de usuários vazia, siga estas etapas:

1. Registre a hora atual como T.
2. Comece a fazer o upload dos novos membros enviando uma 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 sejam concluídas. Você pode verificar o status das 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 acesse a etapa 4. Ainda recomendamos verificar o status das 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 o upload dos novos membros, deixando apenas os membros recém-adicionados.

Crie a solicitação

Defina os seguintes campos no RemoveAllAudienceMembersRequest corpo:

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. Apenas os membros adicionados antes desse horário serão removidos. Para detalhes de formatação, consulte Formato de carimbo de data/hora. Se não for definido, esse valor será definido como 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 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 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 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 removeAll endpoint.

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.