ebay API属性

时间:2022-12-05 21:50:12

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

区别ReviseFixedPriceItemReviseInventoryStatusReviseItem  

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:创建一个包含可以重复listin*品模板的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美分,所以上传前一定要确保你的产品是优化过的。