API

Remover um contacto de uma audiência

Elimina uma associação e deixa tudo o resto como está. O contacto permanece no livro de endereços, permanece na audiência predefinida e permanece em todas as outras audiências em que estava.

DELETEapi.openemail.uk/audiences/{id}/contacts/{email}

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

DELETE /audiences/{id}/contacts/{email}

Elimina uma associação e deixa tudo o resto como está. O contacto permanece no livro de endereços, permanece na audiência predefinida e permanece em todas as outras audiências em que estava.

Exemplo

Requer audiences:write. Codifique o @ em URL.

curl

curl -X DELETE "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/grace%40example.com" -H "$AUTH"

Resposta

{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "email": "[email protected]",  "deleted": true}

Um contacto que não esteja nesta audiência dá um 404, para que uma gralha não possa relatar uma remoção que nunca aconteceu.

A audiência predefinida integrada não pode ser desbastada. Essa chamada é recusada com 409 audience_immutable, porque contém todos os contactos enquanto forem contactos. Apague o contacto quando for mesmo o contacto que quer ver desaparecer.

Remover o último contacto deixa a audiência no lugar e vazia.