Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
titlepost
 
Anchor
topslws
topslws

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.

Web Service Methods 

 

MethodDescription
AddBulkBulk adds to a Send List.
AddBulkFileBulk adds to a Send List via File Upload.
CreateSendListCreates a an empty 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 To interact with any Web Services, developers must first use the Login method to create a

Status
subtletrue
colourRed
title Service Ticket
 alması gerekir. Diğer web servis ve metodlarına yaratmış olduğu bu değer ile istekte bulunabilir. Developers can send requests to other Web Service and methods using this
Status
subtletrue
colourRed
title Service Ticket
.

 


CreateSendList 
Anchor
createsendlist
createsendlist

Back to Top ^

<CreateSendList>
Boş bir gönderim listesi yaratır
Creates an empty Send List.
Parametreler

Parameters

 

Parametre
Parameter
Değer
Value 
ServiceTicket
Login aksiyonu ile elde edilen ServiceTicket
ServiceTicket obtained through Login

Status
colourGreen
titlemandatory

ListGroup
Listenin grup adı.
Group Name of the List

Status
colourGreen
titlemandatory

ListName
Listenin adı.
Name of the list

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST EXAMPLE
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 EXAMPLE
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

If the request was successful, the

Status
subtletrue
colourRed
titleCode
the parameter will return
Status
subtletrue
colourRed
title00
as a response. In addition to that, the ID of the created list
Status
subtletrue
colourRed
titleCreatedListID
is returned.

Hata Parametreleri

Error Parameters

 

CodeError MessageDetailedMessageDescriptionAçıklama
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yokNo active sessions found. Try login again.

 


AddBulk AddBulk 
Anchor
addbulk
addbulk

Back to Top ^

<AddBulk>
Toplu bir şekilde üye eklemeye olanak verir
Bulk adds to a Send List.
Parametreler

Parameters

 

ParametreParameterDeğerValue 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

ListGroupEklenecek listenin grup adı.

Group name of the List to add

Status
colourGreen
titlemandatory

ListNameListenin adı.Name of the List

Status
colourGreen
titlemandatory

KeyReferans Reference Key Adı. Bu alana göre üye ekleme veya güncelleme yapılacaktır. Referans Key’in değerini DemograficData alanında belirtilmesi gerekir.Name. Member adding and updating will be done based on this field. Reference Key value must be specified in the DemograficData field

Status
colourGreen
titlemandatory

DemograficDataArrayOfEmKeyValue dizisi ile üyeye ait alanlar belirlenir.  string defines the fields for the member

Status
colourGreen
titlemandatory

ForceInsertÜye sistemde var ise, true değeri gönderilmesi durumunda, varolan üye güncellenirIf the member exists in the system and the value is true , the existing member is updated.

Status
colourGreen
titlemandatory

Note
Ad, Soyad gibi alanlar Fields like First Name and Last Name are set through the Related Marketing Cloud platformu üzerinden ayarlanırplatform.
Statik Alanlar

Static Fields

 

Alan AdıField NameAçıklamaDescription
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 EXAMPLE
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 EXAMPLE
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

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 the parameter will return
Status
subtletrue
colourRed
title00
as a response.

Hata Parametreleri

Error Parameters

 

CodeError Message
DetailedMessageAçıklama
Description
9998No session. Please try re-logon.
 Login metodu çalıştırılmamış. Aktif oturum yok
No active sessions found. Try login again.
99No such list!
 Belirtilen liste bulunamadı
The specified List cannot be found.
99Member is new. No update!
 
If 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
is false and the user does not exist in the system, this error is given.  The member is not added. To add the new member in the system the value of the ForceInsertparameter must be true.

 


AddBulkFile AddBulkFile 
Anchor
addbulkfile
addbulkfile

Back to Top ^

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

Parametreler

 

ParametreDeğer
Allows you to add all the members listed in a file to your RMC account in bulk.

Parameters

 

ParameterValue 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

ListGroupEklenecek listenin grup adı.Group name of the List to add

Status
colourGreen
titlemandatory

ListNameListenin adı.Name of the List

Status
colourGreen
titlemandatory

KeyReferans

Reference Key

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

Name. Member adding and updating shall be done based on this field.

Status
colourGreen
titlemandatory

MapDosyada ki alanların sistem alanları ile eşleştirilmesini yapar. ÖrnMaps the fields in the file with the system fields. E.g. 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 EXAMPLE
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>
            <File>base64Binary</File>
            <FileType>string</FileType>
            <NotificationEmail>string</NotificationEmail>
        </AddBulkFile>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleORNEK RESPONSE EXAMPLE
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

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 the parameter will return
Status
subtletrue
colourRed
title00
as a response. In addition to that, the ID of the created list
Status
subtletrue
colourRed
titleCreatedListID
 is returned.

Hata Parametreleri

Error Parameters

 

CodeError MessageDetailedMessageAçıklamaDescription
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yokNo active sessions found. Try login again.
99Not a valid file type. It must be ZIP or CSV or TXT. 

 

 


QuerySendListMemberCount 
Anchor
querymemcount
querymemcount

Back to Top ^

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

Parameters

 

ParametreParameterDeğerValue 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

ListIDListe List ID

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST EXAMPLE
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 EXAMPLE
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

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 the parameter will return
Status
subtletrue
colourRed
title00
as a response.

Hata Parametreleri

Error Parameters

 

 

CodeError MessageDetailedMessageAçıklamaDescription
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yokNo active sessions found. Try login again.

 


RemoveBulkFile 
Anchor
removebulkfile
removebulkfile

Back to Top ^

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

Parametreler

 

ParametreParameterDeğerValue 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicketServiceTicket obtained through Login

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 EXAMPLE
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 EXAMPLE
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

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 the parameter will return
Status
subtletrue
colourRed
title00
as a response. In addition to that, the ID of the created list
Status
subtletrue
colourRed
titleCreatedListID
 is returned.

Hata Parametreleri

Error Parameters

 

 

CodeError MessageDetailedMessageAçıklamaDescription
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yokNo active sessions found. Try login again.

 


RemoveSendList 
Anchor
removesendlist
removesendlist

Back to Top ^

<RemoveSendList>
Bir gönderim listesini siler.
Parametreler

Parameters

 

ParametreParameterDeğerValue 
ServiceTicketLogin aksiyonu ile elde edilen ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

ListGroupListenin grup adı.

Status
colourGreen
titlemandatory

ListNameListenin adı.

Status
colourGreen
titlemandatory

Code Block
languagexml
titleORNEK REQUEST EXAMPLE
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">
            <ServiceTicket>string</ServiceTicket>
            <ListGroup>string</ListGroup>
            <ListName>string</ListName>
        </RemoveSendList>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleORNEK RESPONSE EXAMPLE
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>
        <RemoveSendListResponse
            xmlns="http://ws.euromsg.com/sendlist">
            <RemoveSendListResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <CreatedListID>0</CreatedListID>
            </RemoveSendListResult>
        </RemoveSendListResponse>
    </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 the parameter will return
Status
subtletrue
colourRed
title00
as a response. Aside from that, the returned
Status
subtletrue
colourRed
title99
values indicate errors.

Hata Parametreleri

Error Parameters

 

CodeError MessageDetailedMessageAçıklamaDescription
9998No session. Please try re-logon. Login metodu çalıştırılmamış. Aktif oturum yokNo active sessions found. Try login again.