发送商品更新

如要发送商品更新,请使用 /{catalog_id}/batch 端点。

如要创建、更新或删除目录中的商品,请向以下端点发送 HTTP POST 调用:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>

参数

虽然 /{catalog_id}/batch/{catalog_id}/items_batch 的参数名称可能看起来相似,但是这两个参数截然不同。

建议使用 /{catalog_id}/items_batch API,因为该 API 支持更多用例,同时我们会积极维护这一 API。

参数 类型 描述

allow_upsert

布尔值

allow_upsertfalse 时,系统不会为目录中不存在商品完成更新请求。而是会创建新商品。

requests

对象

包含所有请求的 JSON 对象。

requests.data

对象

包含商品字段及值的 JSON 对象。

  • 如果方法为 CREATE,此对象必须包含所有必要字段。
  • 如果方法为 UPDATE,此对象可包含任何字段。

注意:请参阅可传递的支持的字段

requests.method

字符串

CREATEUPDATEDELETE

requests.retailer_id

字符串

广告主提供的商品 id,而非 FBID。

UPDATE 方法也可以用于创建当前不存在的商品。

详情请参阅 API 参考文档

限制

  • requests 参数最多可包含 5,000 项更新。
  • 对于每个目录,您每小时可执行由目录批处理商家用例流量限制公式定义的调用次数。如果这无法满足您的需求,请联系我们。
  • 批次大小的上限为 5,000。
  • 错误代码 1 和消息 "Please reduce the amount of data you're asking for, then retry your request" 表示 API 请求中收到的数据量(以字节为单位)太大。如要解决此问题,请减少这一批次的商品数量,然后重试。这将确保此请求在可接受的大小限制范围内,从而可以成功得到处理。

支持的字段

请参阅 /{catalog_id}/batch 端点支持的字段清单。

详细了解