Kontakte in Massen aus einer Audience entfernen
Nimmt bis zu 200 Kontakte in einem Aufruf aus einer Audience, nach Adresse. Jeder davon bleibt im Adressbuch, in der Standard-Audience und in jeder anderen Audience, in der er war.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /audiences/{id}/contacts/batch-remove
Nimmt bis zu 200 Kontakte in einem Aufruf aus einer Audience, nach Adresse. Jeder davon bleibt im Adressbuch, in der Standard-Audience und in jeder anderen Audience, in der er war.
Beispiel
Erfordert audiences:write. Der Body hat dieselbe Form wie beim Hinzufügen in Massen: emails mit 1 bis 200 Adressen.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch-remove" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "removed": 1, "notInAudience": ["[email protected]"], "missing": ["[email protected]"]}removed zählt die entfernten Mitgliedschaften, notInAudience listet die Kontakte, die nicht in dieser Audience waren, und missing die Adressen, die gar keine Kontakte sind. Mit keiner der beiden Listen geschieht etwas, der Aufruf ist also sicher wiederholbar.
Die eingebaute Standard-Audience kann nicht ausgedünnt werden. Der Aufruf wird mit 409 audience_immutable abgelehnt, und nichts wird entfernt. Löschen Sie einen Kontakt, wenn er wirklich gehen soll.