Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

POST 

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 Service Methods 

 

MethodDescription
AddBulkBulk adds to a Send List.
AddBulkFileBulk adds to a Send List via File Upload.
CreateSendListCreates 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.

 

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.

 

To interact with any Web Services, developers must first use the Login method to create a SERVICE TICKET. Developers can send requests to other Web Service and methods using this SERVICE TICKET.

 


CreateSendList 

Back to Top ^

<CreateSendList>
Creates an empty Send List.

Parameters

 

ParameterValue 
ServiceTicketServiceTicket obtained through Login

MANDATORY

ListGroupGroup Name of the List

MANDATORY

ListNameName of the list

MANDATORY

REQUEST EXAMPLE
<?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>
RESPONSE EXAMPLE
<?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>

If the request was successful, the CODE parameter will return 00 as a response. In addition to that, the ID of the created list CREATEDLISTID is returned.

Error Parameters

 

CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.

 


AddBulk 

Back to Top ^

<AddBulk>
Bulk adds to a Send List.

Parameters

 

ParameterValue 
ServiceTicketServiceTicket obtained through Login

MANDATORY

ListGroup

Group name of the List to add

MANDATORY

ListNameName of the List

MANDATORY

KeyReference Key Name. Member adding and updating will be done based on this field. Reference Key value must be specified in the DemograficData field

MANDATORY

DemograficDataArrayOfEmKeyValue  string defines the fields for the member

MANDATORY

ForceInsertIf the member exists in the system and the value is true , the existing member is updated.

MANDATORY

Fields like First Name and Last Name are set through the Related Marketing Cloud platform.

Static Fields

 

Field NameDescription
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
REQUEST EXAMPLE
<?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>
RESPONSE EXAMPLE
<?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>

If the request was successful, the CODE parameter will return 00 as a response.

Error Parameters

 

CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99No such list!The specified List cannot be found.
99Member is new. No update!If ForceInsert 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 

Back to Top ^

<AddBulkFile>
Allows you to add all the members listed in a file to your RMC account in bulk.

Parameters

 

ParameterValue 
ServiceTicketServiceTicket obtained through Login

MANDATORY

ListGroupGroup name of the List to add

MANDATORY

ListNameName of the List

MANDATORY

Key

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

MANDATORY

MapMaps the fields in the file with the system fields. E.g. EMAIL=email; COLUMN1=NameSurname; COLUMN2=KeyID

MANDATORY

FileYüklenecek dosya.

MANDATORY

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

MANDATORY

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

MANDATORY

REQUEST EXAMPLE
<?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>
RESPONSE EXAMPLE
<?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>

If the request was successful, the CODE parameter will return 00 as a response. In addition to that, the ID of the created list CREATEDLISTID is returned.

Error Parameters

 

CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Not a valid file type. It must be ZIP or CSV or TXT. 

 


QuerySendListMemberCount 

Back to Top ^

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

Parameters

 

ParameterValue 
ServiceTicketServiceTicket obtained through Login

MANDATORY

ListIDList ID

MANDATORY

REQUEST EXAMPLE
<?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>
RESPONSE EXAMPLE
<?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>

If the request was successful, the CODE parameter will return 00 as a response.

Error Parameters

 

 

CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.

 


RemoveBulkFile 

Back to Top ^

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

Parametreler

 

ParameterValue 
ServiceTicketServiceTicket obtained through Login

MANDATORY

ListGroupListe grup adı.

MANDATORY

ListNameListenin adı.

MANDATORY

KeyReferans Key Adı.

MANDATORY

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

MANDATORY

FileYüklenecek dosya.

MANDATORY

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

MANDATORY

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

MANDATORY

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

MANDATORY

REQUEST EXAMPLE
<?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>
RESPONSE EXAMPLE
<?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>

If the request was successful, the CODE parameter will return 00 as a response. In addition to that, the ID of the created list CREATEDLISTID is returned.

Error Parameters

 

 

CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.

 


RemoveSendList 

Back to Top ^

<RemoveSendList>
Bir gönderim listesini siler.

Parameters

 

ParameterValue 
ServiceTicketServiceTicket obtained through Login

MANDATORY

ListGroupListenin grup adı.

MANDATORY

ListNameListenin adı.

MANDATORY

REQUEST EXAMPLE
<?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>
RESPONSE EXAMPLE
<?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>

If the request was successful, the CODE parameter will return 00 as a response. Aside from that, the returned 99 values indicate errors.

Error Parameters

 

CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.

 


 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  • No labels