发送本地化商品批次

如要发送本地化更新，请使用 /{catalog_id}/localized_items_batch 端点。

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

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

参数

参数	类型	描述
`item_type`	枚举	请求中的商品类型。支持的值：`DESTINATION`、`FLIGHT`、`HOME_LISTING`、`HOTEL`、`HOTEL_ROOM`、`PRODUCT_ITEM`、`VEHICLE`、`VEHICLE OFFER`。
`requests`	对象	包含所有请求的 JSON 对象。
`requests.data`	对象	包含商品字段及值的 JSON 对象。如果方法为 `CREATE`，此对象必须仅包含指定 `item_type` 的本地化字段。
`requests.method`	字符串	`CREATE`、`UPDATE`、`DELETE`
`requests.localization`	对象	JSON 对象，当中包含您希望应用于指定目录商品的本地化数据。此对象必须包含以下字段： `type` — 支持的值：`LANGUAGE`、`COUNTRY` 或 `LANGUAGE_AND_COUNTRY` `value` — 可以是任何有效的语言或国家/地区代码，具体取决于所选类型。注意，对于 `LANGUAGE_AND_COUNTRY`，值应该使用“\|”分隔，例如 `en_XX\|US`。请在此查看语言和国家/地区代码列表。

本地化目录设置中包含目录覆盖的支持语言和国家/地区清单，以及通过 LANGUAGE、COUNTRY 或 LANGUAGE_AND_COUNTRY 进行本地化时的覆盖类型及值的示例。如要查看目录字段的支持清单，请参阅支持的字段 — 本地化目录。

注意：price、sale_price、unit_price、base_price、status（可见性）以及 availability 等，必须仅使用一个国家/地区信息库提供。这些字段无法在一个语言信息库中提供。这有助于确保客户看到正确的本地化产品数据。

限制

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

支持的字段

有关 /{catalog_id}/localized_items_batch 端点，请参阅支持的字段清单及每个字段相应的说明：

另请参阅

示例

样本请求

POST /{catalog_id}/*localized_items_batch*
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
       "data": {
         "id": "retailer-2",
         "title": "C'est un tshirt",
         "description": "Le t-shirt a un joli motif",
         "link": "http://www.fr.example.com/t-shirts/1.png"
       }
    },
    {
      "method": "CREATE",
      "localization": {
        "type": "COUNTRY",
         "value": "FR"
      },
       "data": {
         "id": "retailer-2",
         "availability": "in stock",
         "price": "9.99 EUR"
       }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
      "data": {
        "id": "retailer-3",
        "availability": "out of stock",
        "link": "http://www.fr.example.com/t-shirts/2.png"
      }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-3",
        "price": "19.99 USD"
      }
    },
    {
      "method": "DELETE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-4"
      }
    }
  ]
}

样本响应

"handles": ["AczBWxwCxXv4s3xQpm0JwXBlhs-IPGatrWmDRBmc1wTYrV5JvtkuQRT_FOCmKZGmHvotvvX8UtQnwEgg16wTx14cqPYzWVzmxZiaZDLgMUmjSA"]

此端点不会新建目录商品。所有请求均应包含数据 JSON 对象，当中包含现有目录商品的编号。

深度链接

您可以使用 applink 字段指定深度链接信息；其工作方式与深度链接类似。请按下方的 JSON 格式提供深度链接信息。

"applink" : {"ios": [{"url":"example-ios://electronic","app_store_id":42,"app_name":"Electronic Example iOS"}],"iphone": [{"url":"example-iphone://electronic","app_store_id":43,"app_name":"Electronic Example iPhone"}],"ipad": [{"url":"example-ipad://electronic","app_store_id":44,"app_name":"Electronic Example iPad"}],"android": [{"url":"example-android://electronic","package":"com.electronic","class":"com.electronic.Example","app_name":"Electronic Example Android",}],"windows_phone": [{"url":"example-windows://electronic","app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0","app_name":"Electronic Example Windows"}]}

字段名称将与深度链接中的字段名称稍有不同，因为每种应用类型均为独立节点，且包含于该应用类型相应的字段中。

'data\[applink\]\[android\]' 是一个数组，其中仅包含一个在其下指定的值。对于其他应用类型也是如此。

我们不支持 iOS 通用链接。

如要本地化任何应用链接字段，您必须提供所有相关字段。详细了解商品深度链接。

详细了解

发送商品更新 — /{catalog_id}/items_batch
检查批处理请求状态 - /{catalog_id}/check_batch_request_status
目录
- 参考文档 > 商品目录
- 本地化目录设置、支持的字段 — 本地化目录