ebay api GetMyMessages 函数

GetMyMessages

http://developer.ebay.com/devzone/xml/docs/Reference/ebay/GetMyMessages.html#samplefolders

函数介绍：得到发送到消息收件箱的所有详细。通过细节级别（detail level），可以得到消息的个数，headers，解决状态，resolution status and flagged status, and message text.

Note: GetMyMessages requires a DetailLevel in the request. 

 

注意：警告消息部分现在已经发送到消息收件箱，（and the Alerts container is empty），对于每一个高优先级的消息， Flagged属性被标记为true，这意味着，警告消息存在于消息收件箱的时候有一个flag。卖家不要在特定的时间内处理这个事件消息（可能是case等争议问题，现在都发送到收件箱，在收件箱内，不同的消息类型对应不同的操作）。

 

GetMyMessages 返回的消息类型比 GetMemberMessages.要多很多，

GetMemberMessages returns more nodes per message than GetMyMessages.

GetMyMessages函数的返回值可以看做一个消息通知。内容参看：

http://developer.ebay.com/devzone/guides/ebayfeatures/Notifications/Notif-MyMessages.html

 

为了提高效率，可以第一次使用GetMyMessages DetailLevel ， ReturnHeaders的值设置为 ReturnHeaders，不要指定messageid，执行后将返回message id，Your application should be able to cache the returned message ID values. Your application also should be able to create new My Messages requests (up to 10 cached message ID values per request).

 

使用细节：

DetailLevel的值可以选择ReturnHeaders 或 ReturnMessages, GetMyMessages 每次请求只能最多处理10个message ID.

 

属性过滤：

1.通过开始和结束时间过滤（start and end time ）

消息每次返回的最大值为200，如果超过200，可以通过starttime和endtime去取一个特定的时间的消息。

2.使用detail levels ，使用ReturnHeaders ，可以返回MessageID ，Keep calling GetMyMessages with a DetailLevel of ReturnMessages, and 10 MessageID values, until you have retrieved all messages.

3.使用folder names（就是左侧的收件箱，发件箱等），通过指定FolderID去返回指定folder的消息。Inbox的FolderID的默认值是0，如果超过200，使用属性过滤。

 

开始你的调用：

第一次使用GetMyMessages，DetailLevel 设置为 ReturnHeaders, 不写入MessageID 的值，将返回，一个massage id 的list，得到这些message id ，然后第二次使用 GetMyMessages ，DetailLevel 设置为 ReturnMessages，得到指定消息的详细内容。

 

GetMyMessages Input

EndTime  ：时间过滤选项，结束时间点

ExternalMessageIDs：这一属性目前可用在美国网站。用于唯一识别一个给定的用户消息。如果在消息创建时所提供的，此ID可以用来撷取讯息，并会优先于消息ID。

ExternalMessageIDs.ExternalMessageID：Currently available on the US site. A message ID that uniquely identifies a message for a given user. If provided at the time of message creation, this ID can be used to retrieve messages, and will take precedence over the message ID. A total of 10 message IDs can be specified. 

 

FolderID：我的消息folder的唯一值，譬如inbox的folderID就是0

IncludeHighPriorityMessageOnly：如果设置为true，返回的只有High 

 

Priority messages

MessageIDs:里面可以包含1-10个messageID，但是不能超出10个

MessageIDs.MessageID消息的id，唯一标示

Pagination：指定分页。容器

Pagination.EntriesPerPage：每页的个数，

对本函数- GetMyMessages默认的个数为25。最大是200

对于函数GetOrders 最大值是100，默认是25

对于函数GetUserDisputes，这个强制规定是200

对于函数GetProducts，最大值是20.

 

Pagination.PageNumber：指定页数，默认是第一页，有一些特别的默认值是0，（Default is 1 for most calls. For some calls, the default is 0. ）

指定的页数要小于页面的总页数，（总个数通过您初始的请求获得）

Min: 1. Default: 1.

 

StartTime：时间过滤选项，对应的时间是消息发送的时间。

 

Standard Input Fields ：

DetailLevel：可供选择的值：ReturnHeaders，ReturnMessages，ReturnSummary，ReturnSummary可以得到folderid，---this detail level is the only way to retrieve FolderID and FolderName values.

ErrorLanguage：报错语言

MessageID：

OutputSelector：用来指定返回的field，也就是返回那些元素（xml）。

Version：

WarningLevel：

 

GetMyMessages Output

Messages：容器

 

Messages.Message：容器

Messages.Message.Content：邮件正文以纯文本格式。邮件正文中显示为纯文本，即使对eBay的用户的首选电子邮件格式首选项设置为HTML，都会丢弃。

Messages.Message.ExpirationDate：邮件过期日期

Messages.Message.Flagged：Indicates if the message is displayed with a flag in the seller's My Messages mailbox on eBay. It is strongly recommended that the seller act on the message by the specified date (or within 60 days, if not specified).

Messages.Message.Folder：消息所在的folder

 

Messages.Message.Folder.FolderID：  folder id

Messages.Message.ForwardDetails：如果消息被转发，那么返回转发的详细

Messages.Message.HighPriority：指示此消息被标记为高优先级消息。

Messages.Message.ItemEndTime：Date and time for the ended item. 

Messages.Message.ItemID：Unique item ID. Not returned for messages that haven't been associated with a specific item.
Max length: 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits). 

Messages.Message.ItemTitle：消息的title，最大55个字符

Messages.Message.ListingStatus：

Messages.Message.MessageID：message的唯一标示，这个值不同于GetMemberMessages 的 MessageID，， 他的是 GetMyMessages ExternalID

Messages.Message.MessageMedia：Media details stored as part of the message. 

Messages.Message.MessageMedia.MediaName 图片的名字，Max length: 100.

Messages.Message.MessageMedia.MediaURL：图片的链接，Max length: 200. 

Messages.Message.MessageType：消息的类型，只在us site中有效。

All：全部的类型

AskSellerQuestion：买卖双方发起的消息问题

ClassifiedsBestOffer：议价引起的问题

ClassifiedsContactSeller：联系卖家的消息

ContactEbayMember:ebay member 之间的消息

ContacteBayMemberViaAnonymousEmail：当ebay收到一封ebay member的发给另外一个member的邮件，这个消息就会发起

。。。。等等，其他的类型不写了

Messages.Message.QuestionType：问题类型：

CustomCode

CustomizedSubject