Skip Navigation Links.
展开 最小化

SpreadWebServcie.GetUploadRequestStatus Method

獲取聯絡人名單上傳的狀態.

參數

參數

類型

描述

loginEmail

String

Spread賬號的登錄郵箱.

APIKey

String

Spread賬號的密碼或者 API Key which you can retrieve from your Spread account (My account=> Settings).

RequestID

String

SpreadWebServcie.UploadContactListFile 方法返回的RequestID.

返回結果

DatasetException. 如果成功,則返回含有一張Datatable的Dataset,否則返回異常(Exception)。

請在下列表格中找到詳細的返回信息:

狀態/場景

返回類型

返回信息

成功獲取上傳狀態的信息

Dataset

返回含有一張Datatable的Dataset。請在下列表格中找到返回的Datatable詳細的信息。

輸入錯誤的賬號或者API Key

Exception

拋出一個異常含有信息 'Spread Email and Password not match!'。

輸入的Request ID不符合Guid格式。

Exception

拋出一個異常含有信息 'Request ID AAAABBBB-CCCC-DDDD-EEEE-FFFFGGGGHHHH is invalid!'。

輸入錯誤的Request ID。

Exception

拋出一個異常含有信息 'You don't have permission to implement the operation!'。

其他錯誤情況,比如超時。

Exception

拋出一個異常含錯誤信息。

請在下列表格中找到返回的Datatable詳細的信息。

類型

內容

RequestID

Guid

AAAABBBB-CCCC-DDDD-EEEE-FFFFGGGGHHHH

UploadStatus

String

UploadingCompleteError

category_name

String

備註: 上傳的聯絡人名單名稱。

UploadTime

DateTime

備註: 開始上傳的時間。

TotalCount

Integer

0

NewCount

Integer

0

DuplicateCount

Integer

0

DeletedCount

Integer

0

ExistingCount

Integer

0

SpamCount

Integer

0

UnsubscribedCount

Integer

0

DoNotMailCount

Integer

0

UndeliverableCount

Integer

0

asUnconfirmedCount

Integer

0

InvalidCount

Integer

0

HasUploadNo

Integer

1000

備註: 已經上傳的聯絡人總數。

例子

string loginEmail = "Spread@reasonables.com";

string APIKey = "TEST0000-TEST-0000-TEST-0000TEST0000";

string RequestID = "38806E59-AAAA-BBBB-CCCC-15A7BFC0D226";

SpreadAPI.SpreadWebService MySpread = new SpreadAPI.SpreadWebService();

DataSet result = MySpread.GetUploadRequestStatus(loginEmail, APIKey , RequestID);

Dim loginEmail As String = "Spread@reasonables.com"

Dim APIKey As String = "TEST0000-TEST-0000-TEST-0000TEST0000"

Dim RequestID As String = "38806E59-AAAA-BBBB-CCCC-15A7BFC0D226"

Dim MySpread As New SpreadAPI.SpreadWebService

Dim result As DataSet = MySpread.GetUploadRequestStatus(loginEmail, APIKey, RequestID)

    /**
    * @name     GetUploadRequestStatus
    * @function get contact list upload status
    * @param
    *  RequestID The request id of SpreadWebServcie.UploadContactListFile return .
    * @return
    *          dataset.
    */
    public function GetUploadRequestStatus($loginEmail,$APIKey,$RequestID){
        $array = array(
	        'loginEmail'        => $loginEmail,
	        'APIKey'	    => $APIKey,
	        'RequestID'  => $RequestID

        );
        $Client=new SoapClient("http://service.rspread.com/Service.asmx?WSDL");
        return $Client -> GetUploadRequestStatus( $array );
    }

         
No sample.

參見