发送商品更新

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

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

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/items_batch?requests=<REQUESTS>
参数 类型 描述

allow_upsert

布尔值

非必要:如要阻止更新请求创建新商品,请将此参数设为 true

此参数设为 false 时,系统不会为目录中不存在的商品完成更新请求,而是会创建新商品。

item_type

枚举

请求中的商品类型。值:DESTINATIONFLIGHTHOME_LISTINGHOTELHOTEL_ROOMPRODUCT_ITEMVEHICLEVEHICLE OFFER

requests

对象

包含所有请求的 JSON 对象。

requests.data

对象

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

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

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

requests.method

字符串

CREATEUPDATEDELETE

详情请参阅 API 参考文档

限制

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