傳送本地化品項批次

若要傳送本地化更新，請使用 /{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
目錄
- 參考資料：商品目錄
- 本地化目錄設定、支援的欄位 - 本地化目錄