Löschen von Abonnenten - DeleteSubscribers

Die Methode DeleteSubscribers ermöglicht es Abonnenten entweder anhand ihrer eindeutigen Bezeichner oder anhand von verschiedenen Kriterien zu löschen.

Nachrichtenklassen

Das Request-Objekt:

Dieses Objekt beinhaltet entweder ein Array von Abonnenten-Ids (SubscriberIds) oder ein Array von Kriterien (Conditions) die als Löschkriterium dienen. Falls beide Eigenschaften gesetzt sind werden nur die Abonnenten-Ids verwendet.

Codebeispiel:
Ein C# Codebeispiel zur Veranschaulichung der Verwendung:
Variante1: Verwendung der Eigenschaft SubscriberIds
…
SubscriberDeleteRequest req = new SubscriberDeleteRequest();
req.SubscriberIds = new Guid[] { myGuid1, myGuid2};
SubscriberDeleteResponse resp = agent.DeleteSubscribers(req);
…
Variante2: Verwendung der Eigenschaft Conditions
…
SubscriberDeleteRequest req = new SubscriberDeleteRequest();
//get the fields
SubscriberFieldRequest fieldRequest = new SubscriberFieldRequest();
fieldRequest.FieldType = FieldType.CustomInformation;
Field[] fields = agent.GetSubscriberFields(fieldRequest).Fields;
Condition cond = new Condition();
//get field with internal name 'löschkriterium'
cond.Field = fields.First(n => n.InternalName.Equals("löschkriterium"));
cond.Operator = ConditionOperator.Equals;
cond.Value = "lösch mich";
req.Conditions = new Condition[] { cond };
SubscriberDeleteResponse resp = agent.DeleteSubscribers(req);
…

Das Response-Objekt:

Das Response-Objekt SubscriberDeleteResponse ist der Rückgabewert der Funktion DeleteSubscribers, enthält aber keine weiteren Informationen bezüglich des Löschvorgangs.