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.
|
返回结果
Dataset 或 Exception. 如果成功,则返回含有一张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
|
Uploading 或 Complete 或 Error
|
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 = "7D2B83DF-B4A3-4E42-8D77-E6B22A1004BE";
string RequestID = "38806E59-AAAA-BBBB-CCCC-15A7BFC0D226";
SpreadAPI.SpreadWebService MySpread =
new SpreadAPI.SpreadWebService();
DataSet
result = MySpread.GetUploadRequestStatus(loginEmail, APIKey , RequestID);
参见