テスト環境から本番環境に商品グループを公開します。UPSERT 動作を使用します — 商品の公開(初回公開のみ)とは異なり、変更後に再公開できます。
POST /v1/actions/subscription-product-group/publish-group
認証: API Key
このエンドポイントには X-Environment ヘッダーを含めないでください。公開は常にテストから本番環境への一方向です。
リクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|
id | string | Yes | グループ ID(UUID フォーマット、テスト環境のグループである必要があります) |
リクエスト例
await client.subscriptionProductGroups.publish({
id: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",
});
商品の公開とは異なり、グループの公開は繰り返しの UPSERT 操作をサポートしています。テストグループを更新し、いつでも本番環境に再公開できます。本番環境のグループは現在のテストグループに合わせて作成または更新されます。
エラー
リトライポリシー:4xx は一切リトライしない — リクエストを修正してから再送信。5xx は指数バックオフでリトライ(5s 開始、最大 3 回)。
| ステータス | errors[0].message | 意味 | 推奨処理 |
|---|
| 400 | Missing required field: id | リクエストボディに id が含まれない | id を追加して再送信 |
| 400 | Can only publish test environment groups | 指定されたグループはすでに production(または test 以外)にある | 公開可能なのは test 環境のグループのみ |
| 400 | Cannot publish: product_ids is empty | グループにメンバー商品がない | update-group でグループに 1 つ以上の商品を追加してから再送信 |
| 404 | Group not found | 指定された id のグループが存在しない | id が自分のストアに属しているか確認 |
| 500 | Internal server error | 内部エラーまたは一時的な下流障害 | 指数バックオフでリトライ(5s 開始、最大 3 回) |