Service URL | sendlist.asmx |
---|
SendList web servisini kullanarak, toplu veri aktarımı, gönderim listesi yaratabilir veya mevcut gönderim listelerini hesabınızdan silebilirsiniz.
SendList web servisine ait aşağıda ki metodlar bulunmaktadır.
Method | Description |
---|---|
AddBulk | Bulk adds to a Send List. |
AddBulkFile | Bulk adds to a Send List via File Upload. |
CreateSendList | Creates a Send List. |
QuerySendListMemberCount | Returns Member Count in a given Send List. |
RemoveBulkFile | Bulk removes from a Send List or deletes members via File Upload. |
RemoveSendList | Removes a Send List. |
CreateSendList
<CreateSendList> |
---|
Boş bir gönderim listesi yaratır. |
Parametreler
Parametre | Değer | |
---|---|---|
ServiceTicket | Login aksiyonu ile elde edilen ServiceTicket | MANDATORY |
ListGroup | Listenin grup adı. | MANDATORY |
ListName | Listenin adı. | MANDATORY |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <CreateSendList xmlns="http://ws.euromsg.com/sendlist"> <ServiceTicket>string</ServiceTicket> <ListGroup>string</ListGroup> <ListName>string</ListName> </CreateSendList> </soap:Body> </soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <CreateSendListResponse xmlns="http://ws.euromsg.com/sendlist"> <CreateSendListResult> <Code>00</Code> <Message /> <DetailedMessage /> <CreatedListID>1686794</CreatedListID> </CreateSendListResult> </CreateSendListResponse> </soap:Body> </soap:Envelope>
Hata Parametreleri
Code | Message | DetailedMessage | Açıklama |
---|---|---|---|
9998 | No session. Please try re-logon. | Login metodu çalıştırılmamış. Aktif oturum yok. |
AddBulk
<AddBulk> |
---|
Toplu bir şekilde üye eklemeye olanak verir. |
Parametreler
Parametre | Değer | |
---|---|---|
ServiceTicket | Login aksiyonu ile elde edilen ServiceTicket | MANDATORY |
ListGroup | Eklenecek listenin grup adı. | MANDATORY |
ListName | Listenin adı. | MANDATORY |
Key | Referans Key Adı. Bu alana göre üye ekleme veya güncelleme yapılacaktır. Referans Key’in değerini DemograficData alanında belirtilmesi gerekir. | MANDATORY |
DemograficData | ArrayOfEmKeyValue dizisi ile üyeye ait alanlar belirlenir. | MANDATORY |
ForceInsert | Üye sistemde var ise, true değeri gönderilmesi durumunda, varolan üye güncellenir. | MANDATORY |
Statik Alanlar
Alan Adı | Açıklama |
---|---|
Email adresi | |
STATUS | Üye durumu. A : Aktif, P : Pasif |
EMAIL_PERMIT | Email izin durumu. Y : Evet, N : Hayır |
GSM_PERMIT | SMS izin durumu. Y : Evet, N : Hayır |
FAX_PERMIT | FAX izin durumu. Y : Evet, N : Hayır |
CALL_PERMIT | Call Center izin durumu. Y : Evet, N : Hayır |
PRINT_PERMIT | Print izin durumu. Y : Evet, N : Hayır |
REFERRAL | Referans adresi |
REFERRAL_DOMAIN | Referans domain |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <AddBulk xmlns="http://ws.euromsg.com/sendlist"> <ServiceTicket>string</ServiceTicket> <ListGroup>string</ListGroup> <ListName>string</ListName> <Key>string</Key> <DemograficData> <ArrayOfEmKeyValue> <EmKeyValue> <Key>string</Key> <Value>string</Value> </EmKeyValue> <EmKeyValue> <Key>string</Key> <Value>string</Value> </EmKeyValue> </ArrayOfEmKeyValue> <ArrayOfEmKeyValue> <EmKeyValue> <Key>string</Key> <Value>string</Value> </EmKeyValue> <EmKeyValue> <Key>string</Key> <Value>string</Value> </EmKeyValue> </ArrayOfEmKeyValue> </DemograficData> <ForceInsert>boolean</ForceInsert> </AddBulk> </soap:Body> </soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <AddBulkResponse xmlns="http://ws.euromsg.com/sendlist"> <AddBulkResult> <Code>00</Code> <Message /> <DetailedMessage /> <CreatedListID>0</CreatedListID> </AddBulkResult> <DetailsResult> <BulkDetailedResult> <Key>test1@sampledomain.com</Key> <Code>00</Code> <Message /> <DetailedMessage /> </BulkDetailedResult> <BulkDetailedResult> <Key>test2@sampledomain.com</Key> <Code>00</Code> <Message /> <DetailedMessage /> </BulkDetailedResult> </DetailsResult> </AddBulkResponse> </soap:Body> </soap:Envelope>
Hata Parametreleri
Code | Message | DetailedMessage | Açıklama |
---|---|---|---|
9998 | No session. Please try re-logon. | Login metodu çalıştırılmamış. Aktif oturum yok. | |
99 | No such list! | Belirtilen liste bulunamadı. | |
99 | Member is new. No update! | ForceInsert false ise ve kullanıcı sistemde yer almıyorsa alınan hatadır. Üye eklenmemiştir. Yeni üyeyi sistem eklemek için ForceInsert parametresinin değeri true olmalıdır. |
AddBulkFile
<AddBulkFile> |
---|
Bir dosyada yer alan üyelerin toplu olarak Related Marketing Cloud hesabınıza yüklenmesini sağlar. |
Parametreler
Parametre | Değer | |
---|---|---|
ServiceTicket | Login aksiyonu ile elde edilen ServiceTicket | MANDATORY |
ListGroup | Eklenecek listenin grup adı. | MANDATORY |
ListName | Listenin adı. | MANDATORY |
Key | Referans Key Adı. Bu alana göre üye ekleme veya güncelleme yapılacaktır. | MANDATORY |
Map | Dosyada ki alanların sistem alanları ile eşleştirilmesini yapar. Örn. EMAIL=email;COLUMN1=NameSurname;COLUMN2=KeyID. | MANDATORY |
File | Yüklenecek dosya. | MANDATORY |
FileType | Dosya türü. zip veya csv olmalı. | MANDATORY |
NotificationEmail | Yükleme işlemi bittiğinde, burada belirtilen email adresine bilgilendirme emaili gönderilir. | MANDATORY |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <AddBulkFile xmlns="http://ws.euromsg.com/sendlist"> <ServiceTicket>string</ServiceTicket> <ListGroup>string</ListGroup> <ListName>string</ListName> <Key>string</Key> <Map>string</Map> <File>base64Binary</File> <FileType>string</FileType> <NotificationEmail>string</NotificationEmail> </AddBulkFile> </soap:Body> </soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <AddBulkFileResponse xmlns="http://ws.euromsg.com/sendlist"> <AddBulkFileResult> <Code>00</Code> <Message /> <DetailedMessage /> <ConversationID>EEFF123AE537442BBF9AD3231F812684</ConversationID> <CreatedListID>0</CreatedListID> </AddBulkFileResult> </AddBulkFileResponse> </soap:Body> </soap:Envelope>
Hata Parametreleri
Code | Message | DetailedMessage | Açıklama |
---|---|---|---|
9998 | No session. Please try re-logon. | Login metodu çalıştırılmamış. Aktif oturum yok. | |
99 | Not a valid file type. It must be ZIP or CSV or TXT. |
QuerySendListMemberCount
<QuerySendListMemberCount> |
---|
Gönderim listesindeki kişi sayısını gösterir. |