Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Service URLsendlist.asmx

 

SendList web servisini kullanarak, toplu veri aktarımı, gönderim listesi yaratabilir veya mevcut gönderim listelerini hesabınızdan
Service URLsendlist.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.

 

MethodDescription
AddBulkBulk adds to a Send List.
AddBulkFileBulk adds to a Send List via File Upload.
CreateSendListCreates a Send List.
QuerySendListMemberCountReturns Member Count in a given Send List.
RemoveBulkFileBulk removes from a Send List or deletes members via File Upload.
RemoveSendListRemoves a Send List.

 

 

Note
iconfalse

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
iconfalse

Geliştiricinin her hangi bir web servis ile etkileşime geçebilmesi için, öncelikle Login metodunu kullanarak bir 

Status
subtletrue
colourRed
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

 

ParametreDeğer 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicket

Status
colourGreen
titlemandatory

ListGroupListenin grup adı.

Status
colourGreen
titlemandatory

ListNameListenin adı.

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST
linenumberstrue
<?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
languagexml
titleORNEK RESPONSE
linenumberstrue
<?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
subtletrue
colourRed
title<Code>
 parametresi 
Status
subtletrue
colourRed
title00
 olarak cevap döner. Buna ek olarak yaratılan liste ID’si 
Status
subtletrue
colourRed
titleCreatedListID
 döner.

Hata Parametreleri

 

CodeMessageDetailedMessageAçıklama
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yok.

 


AddBulk 
Anchor
addbulk
addbulk

<AddBulk>
Toplu bir şekilde üye eklemeye olanak verir.

Parametreler

 

ParametreDeğer 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicket

Status
colourGreen
titlemandatory

ListGroupEklenecek listenin grup adı.

Status
colourGreen
titlemandatory

ListNameListenin adı.

Status
colourGreen
titlemandatory

KeyReferans 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
colourGreen
titlemandatory

DemograficDataArrayOfEmKeyValue dizisi ile üyeye ait alanlar belirlenir.

Status
colourGreen
titlemandatory

ForceInsertÜye sistemde var ise, true değeri gönderilmesi durumunda, varolan üye güncellenir.

Status
colourGreen
titlemandatory

 

Note
Ad, Soyad gibi alanlar Related Marketing Cloud platformu üzerinden ayarlanır.

Statik Alanlar

 

Alan AdıAçıklama
EMAILEmail adresi
STATUSÜye durumu. A : Aktif, P : Pasif
EMAIL_PERMITEmail izin durumu. Y : Evet, N : Hayır
GSM_PERMITSMS izin durumu. Y : Evet, N : Hayır
FAX_PERMITFAX izin durumu. Y : Evet, N : Hayır
CALL_PERMITCall Center izin durumu. Y : Evet, N : Hayır
PRINT_PERMITPrint izin durumu. Y : Evet, N : Hayır
REFERRALReferans adresi
REFERRAL_DOMAINReferans domain
Code Block
languagexml
titleORNEK REQUEST
linenumberstrue
<?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
languagexml
titleORNEK RESPONSE
linenumberstrue
<?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
subtletrue
colourRed
title<Code>
 parametresi 
Status
subtletrue
colourRed
title00
 olarak cevap döner.

Hata Parametreleri

 

CodeMessageDetailedMessageAçıklama
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yok.
99No such list! Belirtilen liste bulunamadı.
99Member 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 ForceInsertparametresinin değeri true olmalıdır.

 


AddBulkFile 
Anchor
addbulkfile
addbulkfile

<AddBulkFile>
Bir dosyada yer alan üyelerin toplu olarak Related Marketing Cloud hesabınıza yüklenmesini sağlar.

Parametreler

 

ParametreDeğer 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicket

Status
colourGreen
titlemandatory

ListGroupEklenecek listenin grup adı.

Status
colourGreen
titlemandatory

ListNameListenin adı.

Status
colourGreen
titlemandatory

KeyReferans Key Adı. Bu alana göre üye ekleme veya güncelleme yapılacaktır.

Status
colourGreen
titlemandatory

MapDosyada ki alanların sistem alanları ile eşleştirilmesini yapar. Örn. EMAIL=email;COLUMN1=NameSurname;COLUMN2=KeyID.

Status
colourGreen
titlemandatory

FileYüklenecek dosya.

Status
colourGreen
titlemandatory

FileTypeDosya türü. zip veya csv olmalı.

Status
colourGreen
titlemandatory

NotificationEmailYükleme işlemi bittiğinde, burada belirtilen email adresine bilgilendirme emaili gönderilir.

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST
linenumberstrue
<?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><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
languagexml
titleORNEK RESPONSE
linenumberstrue
<?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
subtletrue
colourRed
title<Code>
 parametresi 
Status
subtletrue
colourRed
title00
 olarak cevap döner. Buna ek olarak yaratılan liste ID’si 
Status
subtletrue
colourRed
titleCreatedListID
 döner.

Hata Parametreleri

 

CodeMessageDetailedMessageAçıklama
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yok.
99Not a valid file type. It must be ZIP or CSV or TXT.  

 


QuerySendListMemberCount 
Anchor
querymemcount
querymemcount

<QuerySendListMemberCount>
Gönderim listesindeki kişi sayısını gösterir.

Parametreler

 

ParametreDeğer 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicket

Status
colourGreen
titlemandatory

ListIDListe ID

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST
linenumberstrue
<?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>
        <QuerySendListMemberCount
            xmlns="http://ws.euromsg.com/sendlist">
            <ServiceTicket>string</ServiceTicket>
            <ListID>int</ListID>
        </QuerySendListMemberCount>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleORNEK RESPONSE
linenumberstrue
<?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>
        <QuerySendListMemberCountResponse xmlns="http://ws.euromsg.com/sendlist">
            <QuerySendListMemberCountResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <CreatedListID>0</CreatedListID>
            </QuerySendListMemberCountResult>
            <MemberCount>0</MemberCount>
        </QuerySendListMemberCountResponse>
    </soap:Body>
</soap:Envelope>
Tip
Başarılı istek durumunda 
Status
subtletrue
colourRed
title<Code>
 parametresi 
Status
subtletrue
colourRed
title00
 olarak cevap döner.

Hata Parametreleri

 

CodeMessageDetailedMessageAçıklama
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yok.

 


RemoveBulkFile 
Anchor
removebulkfile
removebulkfile

<RemoveBulkFile>
Bir dosyada yer alan üyelerin seçilerek Related Marketing Cloud hesabınızdan silinmesini sağlar.

Parametreler

 

ParametreDeğer 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicket

Status
colourGreen
titlemandatory

ListGroupListe grup adı.

Status
colourGreen
titlemandatory

ListNameListenin adı.

Status
colourGreen
titlemandatory

KeyReferans Key Adı.

Status
colourGreen
titlemandatory

MapDosyada ki alanların sistem alanları ile eşleştirilmesini yapar. Örn. EMAIL=email;COLUMN1=NameSurname;COLUMN2=KeyID.

Status
colourGreen
titlemandatory

FileYüklenecek dosya.

Status
colourGreen
titlemandatory

FileTypeDosya türü. zip veya csv olmalı.

Status
colourGreen
titlemandatory

NotificationEmailYükleme işlemi bittiğinde, burada belirtilen email adresine bilgilendirme emaili gönderilir.

Status
colourGreen
titlemandatory

DeleteIfInNoListEğer üye hiç bir listede yer almıyorsa, true gönderilmesi durumunda, kullanıcıyı tamamen siler.

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST
linenumberstrue
<?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>
        <RemoveBulkFile 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>
            <DeleteIfInNoList>boolean</DeleteIfInNoList>
        </RemoveBulkFile>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleORNEK RESPONSE
linenumberstrue
<?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>
        <RemoveBulkFileResponse xmlns="http://ws.euromsg.com/sendlist">
            <RemoveBulkFileResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <ConversationID>EEFF123AE537442BBF9AD3231F812684</ConversationID>
                <CreatedListID>0</CreatedListID>
            </RemoveBulkFileResult>
        </RemoveBulkFileResponse >
    </soap:Body>
</soap:Envelope>
Tip
Başarılı istek durumunda 
Status
subtletrue
colourRed
title<Code>
 parametresi 
Status
subtletrue
colourRed
title00
 olarak cevap döner. Buna ek olarak yaratılan liste ID’si 
Status
subtletrue
colourRed
titleCreatedListID
 döner.

Hata Parametreleri

 

CodeMessageDetailedMessageAçıklama
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yok.

 


RemoveSendList 
Anchor
removesendlist
removesendlist

<RemoveSendList>
Bir gönderim listesini siler.

Parametreler

 

ParametreDeğer 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicket

Status
colourGreen
titlemandatory

ListGroupListenin grup adı.

Status
colourGreen
titlemandatory

ListNameListenin adı.

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST
linenumberstrue
<?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>
        <RemoveSendList xmlns="http://ws.euromsg.com/sendlist">
            
<File>base64Binary<
<ServiceTicket>string</
File>
ServiceTicket>
            
<FileType>string<
<ListGroup>string</
FileType>
ListGroup>
            
<NotificationEmail>string<
<ListName>string</
NotificationEmail>
ListName>
        </
AddBulkFile>
RemoveSendList>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleORNEK RESPONSE
linenumberstrue
<?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
<RemoveSendListResponse
            xmlns="http://ws.euromsg.com/sendlist">
            
<AddBulkFileResult>
<RemoveSendListResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />

<ConversationID>EEFF123AE537442BBF9AD3231F812684</ConversationID>
                
<CreatedListID>0</CreatedListID>
            </
AddBulkFileResult>
RemoveSendListResult>
        </
AddBulkFileResponse>
RemoveSendListResponse>
    </soap:Body>
</soap:Envelope>
Tip
Başarılı istek durumunda 
Status
subtletrue
colourRed
title<Code>
 parametresi 
Status
subtletrue
colourRed
title00
 olarak cevap döner.
Buna ek olarak yaratılan liste ID’si 
Bunun dışında dönen
Status
subtletrue
colourRed
title
CreatedListID  döner
99
değerleri hata belirtir.

Hata Parametreleri

 

CodeMessageDetailedMessageAçıklama
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yok.
99Not a valid file type. It must be ZIP or CSV or TXT.

 

 

 

 

 

QuerySendListMemberCount

 

<QuerySendListMemberCount>Gönderim listesindeki kişi sayısını gösterir.