限制和限制条件

本部分介绍使用 Orders API 的限制和限制条件。

配额和费率限制

API 可以免费使用,但具有配额和费率限制,如 Content API for Shopping 已发布内容限制中所述。

已取消的订单

在您更新某商品之前,依据 noInventory 原因取消的订单将会致使该商品从 Shopping Actions 中移除。这不会影响您的购物广告。

订单配送时间

目前,如果订单未在 30 天内配送,Google 将会自动取消此订单。取消原因将是 orderTimeout。商家不能将该值设置为取消原因。

custombatch 的操作顺序

我们无法保证 Custombatch 的操作顺序。请勿在同一批处理请求中包含以下操作:取决于同一批次中其他操作的任何操作。

从概念的角度来看,假设同一批次中的所有操作都同时执行,并且操作的顺序不确定。这通常意味着不会将影响同一 orderId 的操作放在同一批次中,尽管这种经验法则也有例外情况。

请求频率

我们建议的最佳做法是您等待对一个订单中的请求给出答复后,再执行下一个请求。例如,由于请求数据有时需要一些时间才能在我们的系统中生效,因此我们不保证在发出 POST 后立即发出 GET 请求会反映所做的更改。如果您从 POST 请求收到成功的响应,则足以证明 POST 请求已被执行。您无需发出 GET 请求来“重新确认”这一点。

已知问题

由于 API 沙盒仍处于预览状态,因此我们正在着手解决一些已知问题。我们会尝试将此列表与最新版本的 API 保持同步。

list 方法

list 方法有以下已知问题:

  • maxResults:此字段尚未实现,但很快就会提供,默认值为 25 个结果,允许的最大值为 250。
  • orderBy:此字段暂时不支持 ASC(升序),只支持 DESC(降序)。
  • acknowledged:使用 acknowledged 参数时,list 可能会超时。为避免上述问题,请将 placedDateStart 添加到方法调用,并使其值早于一周或一个月前(超过 1 个月的订单将被自动取消)。

    虽然生产环境中尚未出现此问题,但包括 list 调用中的 placedDateStart 参数会减少执行调用所需的时间。

actor 属性

执行退款、取消和退货时有一个 actor 属性,您可以使用该属性确定谁发起了那些相应的操作。但是,在执行 Orders 对象的退款和退货时,此字段尚不可用。

该字段将来可用。