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. |
Note |
---|
|
Hesabınızdan üye silerken dikkatli olmanız gerekir. 2015 Mayıs ayında çıkan yasa gereği, üye geçmiş bilgilerini en az 1 yıl saklamanız gerekmektedir. |
Warning |
---|
|
Geliştiricinin her hangi bir web servis ile etkileşime geçebilmesi için, öncelikle Login metodunu kullanarak bir Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | Service Ticket |
---|
| alması gerekir. Diğer web servis ve metodlarına yaratmış olduğu bu değer ile istekte bulunabilir. |
CreateSendList
Anchor |
---|
| createsendlist |
---|
| createsendlist |
---|
|
<CreateSendList> |
---|
Boş bir gönderim listesi yaratır. |
Parametreler
Parametre | Değer | |
---|
ServiceTicket | Login aksiyonu ile elde edilen ServiceTicket | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
ListGroup | Listenin grup adı. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
ListName | Listenin adı. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
Code Block |
---|
language | xml |
---|
title | ORNEK REQUEST |
---|
linenumbers | true |
---|
|
<?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> |
Code Block |
---|
language | xml |
---|
title | ORNEK RESPONSE |
---|
linenumbers | true |
---|
|
<?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> |
Tip |
---|
Başarılı istek durumunda Status |
---|
subtle | true |
---|
colour | Red |
---|
title | <Code> |
---|
| parametresi Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | 00 |
---|
| olarak cevap döner. Buna ek olarak yaratılan liste ID’si Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | CreatedListID |
---|
| döner. |
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 | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
ListGroup | Eklenecek listenin grup adı. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
ListName | Listenin adı. | Status |
---|
colour | Green |
---|
title | 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. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
DemograficData | ArrayOfEmKeyValue dizisi ile üyeye ait alanlar belirlenir. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
ForceInsert | Üye sistemde var ise, true değeri gönderilmesi durumunda, varolan üye güncellenir. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
Note |
---|
Ad, Soyad gibi alanlar Related Marketing Cloud platformu üzerinden ayarlanır. |
Statik Alanlar
Alan Adı | Açıklama |
---|
EMAIL | 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 |
Code Block |
---|
language | xml |
---|
title | ORNEK REQUEST |
---|
linenumbers | true |
---|
|
<?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> |
Code Block |
---|
language | xml |
---|
title | ORNEK RESPONSE |
---|
linenumbers | true |
---|
|
<?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> |
Tip |
---|
Başarılı istek durumunda Status |
---|
subtle | true |
---|
colour | Red |
---|
title | <Code> |
---|
| parametresi Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | 00 |
---|
| olarak cevap döner. |
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 | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
ListGroup | Eklenecek listenin grup adı. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
ListName | Listenin adı. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
Key | Referans Key Adı. Bu alana göre üye ekleme veya güncelleme yapılacaktır. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
Map | Dosyada ki alanların sistem alanları ile eşleştirilmesini yapar. Örn. EMAIL=email;COLUMN1=NameSurname;COLUMN2=KeyID. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
File | Yüklenecek dosya. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
FileType | Dosya türü. zip veya csv olmalı. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
NotificationEmail | Yükleme işlemi bittiğinde, burada belirtilen email adresine bilgilendirme emaili gönderilir. | Status |
---|
colour | Green |
---|
title | mandatory |
---|
|
|
Code Block |
---|
language | xml |
---|
title | ORNEK REQUEST |
---|
linenumbers | true |
---|
|
<?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> |
Code Block |
---|
language | xml |
---|
title | ORNEK RESPONSE |
---|
linenumbers | true |
---|
|
<?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> |
Tip |
---|
Başarılı istek durumunda Status |
---|
subtle | true |
---|
colour | Red |
---|
title | <Code> |
---|
| parametresi Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | 00 |
---|
| olarak cevap döner. Buna ek olarak yaratılan liste ID’si Status |
---|
| |
---|
subtle | true |
---|
colour | Red |
---|
title | CreatedListID |
---|
| döner. |
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. |