目錄

傳送產品更新

若要傳送產品更新，請使用 /{catalog_id}/items_batch 端點。

若要建立、更新或刪除目錄中的產品，請發出 HTTP POST 呼叫至：

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/items_batch?requests=<REQUESTS>
參數 類型 說明

allow_upsert

布林值

選用項目：如果您不想讓更新要求建立新商品，請將此值設為 true。

若設為 false，針對目錄中不存在的商品，將不會完成更新要求，而是會建立新的商品。

item_type

列舉

要求中的商品類型。值：DESTINATION、FLIGHT、HOME_LISTING、HOTEL、HOTEL_ROOM、PRODUCT_ITEM、VEHICLE、VEHICLE OFFER。

requests

物件

包含所有要求的 JSON 物件。

requests.data

物件

包含產品欄位和值的 JSON 物件。

  • 當方法為 CREATE 時，此物件必須包含指定 item_type 的所有必要欄位。
  • 當方法為 UPDATE 時，此物件可包含任何欄位。

備註：請參閱可傳遞的支援欄位。

requests.method

字串

CREATE、UPDATE、DELETE

如需更多詳細資訊，請參閱 API 參考資料。

限制

  • requests 參數最多可包含 5,000 項商品。
  • 您每小時可對每個目錄發出的呼叫次數，取決於目錄批次商家使用案例速率限制公式所得出的結果。如果次數不夠，請與我們聯絡。
  • 錯誤代碼 1 顯示 "Please reduce the amount of data you're asking for, then retry your request" 訊息，說明 API 要求中接收到的資料大小（以位元組為單位）太大。若要解決此問題，請減少批次中的商品數量，然後再試一次。這麼做可確保要求在可接受的大小限制範圍內，且可成功獲得處理。

支援的欄位

請參閱 /{catalog_id}/items_batch 端點的支援欄位：

瞭解詳情