商品のアップデートを送信する

商品のアップデートを送信するには、/{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時間あたりの回数まで通話することができます。この回数では足りない場合は、Metaまでお問い合わせください。
エラーコードが1でメッセージが"Please reduce the amount of data you're asking for, then retry your request"の場合、APIリクエストで受信したデータのサイズ(バイト単位)が大きすぎることを示しています。この問題を解決するには、バッチ内のアイテム数を減らしてもう一度お試しください。これにより、リクエストを許容可能なサイズ制限内に収め、リクエストを正常に処理することができます。

/{catalog_id}/items_batchエンドポイントについては、サポートされるフィールドをご覧ください。