傳送品項更新

若要傳送品項更新,請使用 /{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 支援更多使用案例,且受積極維護。

參數 類型 說明

allow_upsert

布林值

allow_upsertfalse,系統不會為目錄中不存在的商品完成更新要求。若否,則系統將建立新的商品。

requests

物件

包含所有要求的 JSON 物件。

requests.data

物件

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

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

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

requests.method

字串

CREATEUPDATEDELETE

requests.retailer_id

字串

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

如果商品還不存在,也可以使用 UPDATE 方法來建立商品。

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

限制

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

支援的欄位

請參閱 /{catalog_id}/batch 端點的支援欄位清單。

瞭解詳情