ebay API属性

Ebay Trading API整理

纠纷相关　　

AddDispute:创建一个未支付纠纷 或 取消 a single line item order

AddDisputeResponse:回复/关闭dispute

GetDispute:获取Dispute

GetUserDisputes :获取用户作为买家或卖家的Dispute

SellerReverseDispute

商品相关　　

AddItem:添加一个item

AddFixedPriceItem

AddItemFromSellingManagerTemplate:从Selling Manager templates创建 listing

AddItems:上传1到5个item

AddToItemDescription

AddToWatchList:添加一个或多个item到 My eBay watch list

DisableUnpaidItemAssistance:禁用Unpaid Item Assistant

EndFixedPriceItem:下架fixed-price item

EndItem:下架item

EndItems: 下架10个 items

GetBestOffers:获取商品的Best Offers

GetBidderList:获取用户正在拍、已拍到和已购买的商品

GetItem:Returns item data

GetItemsAwaitingFeedback:返回等待买家或卖家回复feedback的items

GetMyeBayBuying:从My eBay account>Buying section获取watching、biding on、 has won、has made Best Offers 的 item

GetMyeBaySelling:从My eBay account>Selling section获取user is currently selling (the Active list),items that have bids, sold items, and unsold items.

GetSellerList

GetSellingManagerSoldListings:获取已卖掉的商品的信息

RelistFixedPriceItem:重新上传a single fixed-price item 或者 a single multi-item listing 到指定的网站

RelistItem:重新上传a single item 或者 a single multi-item listing 到指定的网站

RemoveFromWatchList:remove one or more items from  My eBay watch list

RespondToBestOffer:接受、拒绝 或 买方还价 => Best Offer

ReviseFixedPriceItem:修改active的 fixed-price item 属性

ReviseInventoryStatus:change the price and quantity of currently active fixed-price items

ReviseItem:修改active listing 属性

VerifyRelistItem:验证重新上传Item

区别ReviseFixedPriceItem、ReviseInventoryStatus、ReviseItem　　

ReviseFixedPriceItem ：

　　　　1、basic fixed-price listings and store inventory listings

　　　　2、gives you an option to track inventory by SKU instead of by ItemID

　　　　3、supports the revising of multi-varation listings

　　　　4、you can revise items in bulk by using the File Transfer API and Bulk Data Exchange API

ReviseItem ：auctions, classified ads, or listings with Best Offer

VerifyAddFixedPriceItem:并不真正上传商品，只是测试一下商品的信息，返回上传需要的价格等信息，供卖家参考

VerifyAddItem

订单相关

AddSecondChanceItem:给予未竞拍成功的买家第二次竞拍的机会

VerifyAddSecondChanceItem:验证AddSecondChanceItem的输入参数，返回模拟的start and end times

AddOrder:合并多个订单，方便买家支付

AddTransactionConfirmationItem:

CompleteSale:在创建了a single line item or multiple line item order，买家做various tasks

GetItemTransactions:返回指定商品的订单

GetOrders:获取身份验证用户的订单，既包括买家也包括卖家

GetOrderTransactions:根据OrderIDs, ItemIDs, or SKU获取一个或多个订单的信息

GetSellerTransactions:As a seller, you can use this call to retrieve all of your order line items

PlaceOffer:make a bid, a best offer, or a purchase on the item specified by the ItemID input field

Message相关

DeleteMyMessages:为用户删除选择的messages

GetMemberMessages:获取买家对你的active item的message

GetMessagePreferences:获取卖家的  Ask Seller a Question (ASQ)

GetMyMessages:获取我的messages

ReviseMyMessages

Category相关

GetCategories:获取最新的catgories

GetCategoryFeatures:根据不同的category获取想应的 listing durations, shipping term requirements 和 Best Offer support

GetCategoryMappings:获取久category IDs 和新 category IDs 的映射

GetCategorySpecifics:获取category 的 item specifics

GetStoreCategoryUpdateStatus:

GetSuggestedCategories:根据关键字获取10个相关的category

SetStoreCategories:改变caller的eBay store 的 category配置信息

Feedback相关

GetFeedback:获取用户或商品或订单的feedback

LeaveFeedback:买/卖家评价

RespondToFeedback:回复feedback或追加后续评论

其他接口

AddSellingManagerInventoryFolder:为用户的Selling Manager account添加一个新的product文件夹

AddSellingManagerProduct:创建一个包含可以重复listing产品模板的Selling Manager product

AddSellingManagerTemplate:添加一个Selling Manager template

AddMemberMessageAAQToPartner:使买家和卖家按一定顺序关系，发送message到彼此的My Messages Inboxes

AddMemberMessageRTQ:让卖家对于an active item回复问题

AddMemberMessagesAAQToBidder:卖家给竞拍者或提出Best Offer的买家发送10条message

ConfirmIdentity:返回已经通过应用程序的同意流程获得授权token的用户ID

DeleteSellingManagerInventoryFolder:删除销售库存管理文件夹

DeleteSellingManagerItemAutomationRule:删除一个产品和Selling Manager automation rules的联系

DeleteSellingManagerProduct:删除一个Selling Manager product

DeleteSellingManagerTemplate:删除一个Selling Manager template

DeleteSellingManagerTemplateAutomationRule:删除一个template和Selling Manager automation rules的联系

FetchToken:检索用户的认证token

GetAccount:获取包括汇总数据在内的eBay account的发票数据

GetAdFormatLeads:Retrieves sales lead information for a lead generation listing.

GetAllBidders:提供三种模式获取用户的拍卖信息

GetApiAccessRules:Use this call to report on how many calls your application has made and how many it is allowed to make

GetChallengeToken:Retrieves a botblock token and URLs for an image or audio clip that the user is to match.

GetCharities:获得慈善机构

GetClientAlertsAuthToken:Retrieves a token required for the GetUserAlerts call in the Client Alerts API.

GetContextualKeywords

GetDescriptionTemplates

GeteBayDetails:根据不同的DetailName获取不同的eBay 详情信息

GeteBayOfficialTime:获取eBay系统的格林威治时间

GetItemShipping:返回卖家提供的商品运输服务

GetMyeBayReminders:从My eBay account 获取所有的Buying和Selling 提醒

GetNotificationPreferences

GetNotificationsUsage

GetPromotionalSaleDetails:获取促销信息

GetSellerDashboard:获取卖家的一个简短的介绍

GetSellerEvents:获取卖家48小时内的 price changes, item 修改, description 修改, and other changes

GetSellingManagerAlerts

GetSellingManagerEmailLog

GetSellingManagerInventory:分页获取销售库存管理

GetSellingManagerInventoryFolder:获取销售库存管理文件夹

GetSellingManagerItemAutomationRule:获取销售管理自动化规则，这个规则可以自动商品上架、保证active商品个数等

GetSellingManagerSaleRecord:获取销售管理记录

GetSellingManagerTemplateAutomationRule:获取销售模板管理自动化规则

GetSellingManagerTemplates

GetSessionID:获取一个session ID，用来创建token(待看)

GetShippingDiscountProfiles

GetStore:通过UserID或者caller获取eBay store 的配置信息

GetStoreCustomPage

GetStoreOptions:eBay商店配置设置的当前列表

GetStorePreferences:用户的eBay Store的喜好

GetTaxTable:获取某一网站的税表

GetTokenStatus

GetUser:获取有关单一eBay用户的数据

GetUserContactDetails

GetUserPreferences:获取用户的喜好

GetVeROReasonCodeDetails

GetVeROReportStatus

MoveSellingManagerInventoryFolder:移动Selling Manager inventory folder

ReviseCheckoutStatus:use this call to update the payment details, the shipping details, and the status of an order

ReviseMyMessagesFolders

ReviseSellingManagerInventoryFolder

ReviseSellingManagerProduct

ReviseSellingManagerSaleRecord

ReviseSellingManagerTemplate

RevokeToken:撤销token

SaveItemToSellingManagerTemplate

SendInvoice:卖家发送发票给买家

SetMessagePreferences

SetNotificationPreferences

SetPromotionalSale:Promotional sales enable sellers to apply discounts and/or free shipping across many listings

SetPromotionalSaleListings:改变被promotional sale影响到的item

SetSellingManagerFeedbackOptions

SetSellingManagerItemAutomationRule

SetSellingManagerTemplateAutomationRule

SetShippingDiscountProfiles:设置运费折扣文件

SetStore:设置caller的eBay store 的配置信息

SetStoreCustomPage:Creates or updates a custom page on a user's eBay Store.

SetStorePreferences:设置user's eBay Store喜好

SetTaxTable:设置卖家给定的网站的税表

SetUserNotes:add, replace, and delete My eBay notes for items that are being tracked in the My eBay All Selling and All Buying areas

SetUserPreferences

UploadSiteHostedPictures　　

　　　　　　　　　　　　　　Uploads a picture to the eBay Picture Service and returns a URL for the picture.

　　　　　　　　　　　　　　1、没有获取上传图片的API，所以返回的图片地址要保存好

　　　　　　　　　　　　　　2、图片上传5天内不用来上传商品或者10天内没调用Large Merchant Service上传商品，图片会被删除

　　　　　　　　　　　　　　3、上传附件不支持Large Merchant Service

　　　　　　　　　　　　　　4、eBay Picture Service(EPS)支持jpg、gif、png、bmp、tif格式，不支持psd等格式。

　　　　　　　　　　　　　　5、图片最大7MB。

ValidateChallengeInput

ValidateTestUserRegistration

VeROReportItems

 

真正开始使用ebay api前，先申请两套账号，sandbox和真正ebay的。
sandbox账号用来测试使用，申请过程请参考其官方文档。

一般我们使用api最常用的操作无非就是上传，更新，删除这3种；其他功能如订单的操作等，这里不再赘述。
先认识一些API CALL吧，因为ebay的API CALL种类繁多，这里只举例一些常用的
添加新产品到ebay平台的有AddFixedPriceItem ，AddItem ，AddItems
AddFixedPriceItem 用于添加固定价格的产品到ebay，类似于淘宝一口价
AddItem 用于添加可变价格产品，类似于淘宝上的拍卖价
AddItems可批量添加产品到ebay，目前最多支持5个产品同时上传

修复产品的有ReviseFixedPriceItem ，ReviseInventoryStatus， ReviseItem
ReviseFixedPriceItem 用于更新固定价格产品的属性，如title，price，库存等，适用于multi-variation产品
ReviseInventoryStatus， 只能改变固定价格产品的price和库存
ReviseItem 更新可变价格产品的属性，如title，price，库存等，(固定价格产品未做测试)

清除产品得有EndFixedPriceItem EndItem EndItems
作用同上所述，不再赘述。

值得注意的是，ebay对上传产品要求很严格，它会检查你产品的所有属性，不合格就不能通过。
比如title长度不能多于80个字符 title，description不能含有非法字符等等
这些CALL每24小时的总共调用限制是5000次，超过5000次将不能在使用，除非你向ebay申请更大的特权，申请后能达到每24小时使用500万次。
ebay每上传一个产品也是要收取手续费的，貌似是0.05美分，所以上传前一定要确保你的产品是优化过的。