メインコンテンツへスキップ
テスト環境から本番環境に商品グループを公開します。UPSERT 動作を使用します — 商品の公開(初回公開のみ)とは異なり、変更後に再公開できます。
POST /v1/actions/subscription-product-group/publish-group
認証: API Key
このエンドポイントには X-Environment ヘッダーを含めないでください。公開は常にテストから本番環境への一方向です。

リクエストボディ

フィールド必須説明
idstringYesグループ ID(UUID フォーマット、テスト環境のグループである必要があります)

リクエスト例

await client.subscriptionProductGroups.publish({
  id: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",
});
商品の公開とは異なり、グループの公開は繰り返しの UPSERT 操作をサポートしています。テストグループを更新し、いつでも本番環境に再公開できます。本番環境のグループは現在のテストグループに合わせて作成または更新されます。

エラー

リトライポリシー:4xx は一切リトライしない — リクエストを修正してから再送信。5xx は指数バックオフでリトライ(5s 開始、最大 3 回)。
ステータスerrors[0].message意味推奨処理
400Missing required field: idリクエストボディに id が含まれないid を追加して再送信
400Can only publish test environment groups指定されたグループはすでに production(または test 以外)にある公開可能なのは test 環境のグループのみ
400Cannot publish: product_ids is emptyグループにメンバー商品がないupdate-group でグループに 1 つ以上の商品を追加してから再送信
404Group not found指定された id のグループが存在しないid が自分のストアに属しているか確認
500Internal server error内部エラーまたは一時的な下流障害指数バックオフでリトライ(5s 開始、最大 3 回)