Web Service Endpoint

すべてのアクティブな加入者のサブスクリプション更新日を延長

サブスクリプションの製品 ID を使用して、対象となるアクティブな加入者全員の更新日を延長します。

App Store Server API 1.7+

object summary

URL

POST https://api.storekit.itunes.apple.com/inApps/v1/subscriptions/extend/mass

Sandbox URL

POST https://api.storekit-sandbox.itunes.apple.com/inApps/v1/subscriptions/extend/mass

HTTP Body

MassExtendRenewalDate
Request

すべてのアクティブな加入者のサブスクリプション更新日を延長するための要求本文。
Content-Type: application/json

反応コード

200 MassExtendRenewalDate Response	OK 要求は成功しました。 requestIdentifier を再利用してエンドポイントを再度呼び出すと、サーバは 200 を返します。 Content-Type: application/json
400 (InvalidExtendByDays Error \| InvalidProduct IdError \| InvalidExtend ReasonCodeError \| InvalidRequest IdentifierError \| InvalidEmptyStorefront CountryCodeListError \| InvalidStorefront CountryCodeError)	不正な要求要求は無効であり、受け付けられません。 Content-Type: application/json
401	認証されていない認証ヘッダー内の JSON Web Token (JWT) が無効です。詳細については、API 要求用の JSON Web トークンの生成をご覧ください。
403 (SubscriptionExtension IneligibleError \| SubscriptionMax ExtensionError)	禁止要求は無効であり、受け付けられません。 Content-Type: application/json
404 StatusRequestNotFound Error	見つからないサーバは、あなたの提供した要求 ID と製品 ID に対するサブスクリプション更新日延長要求を見つけることができませんでした。 Content-Type: application/json
429 RateLimitExceededError	要求がレート制限を超えました。 Content-Type: application/json
500 (GeneralInternalError \| GeneralInternal RetryableError)	内部サーバエラー要求が失敗しました。一時的な障害が原因かもしれません。詳細については、特定のエラーメッセージをご確認ください。 Content-Type: application/json

以下で言及

自動更新サブスクリプションの更新日を延長 (Extending the renewal date for auto-renewable subscriptions)

レート制限の識別

App Store サーバ API の変更履歴

議論

このエンドポイントを使用すると、一時的なサービス停止、イベントのキャンセル、ライブストリーミングイベントの中断などにより、あなたの顧客達の有料アクティブサブスクリプションの更新日を延長することで補償できます。このエンドポイントは、あなたが指定した商品 ID のすべてのアクティブなサブスクリプションに適用され、オプションで指定した店頭に限定されます。

このエンドポイントを呼び出すには、要求本体（MassExtendRenewalDateRequest）に、サービス中断が発生したサブスクリプション商品 ID とその他の情報を指定します。

HTTP 200 ステータスコードで成功した反応には、要求であなたが指定したのと同じ一意の requestIdentifier を含む MassExtendRenewalDateResponse オブジェクトが含まれます。このエンドポイントは非同期要求です。成功した反応は、App Store サーバが要求を処理中であることを示します。HTTP 200 以外のステータスコードは、要求が失敗したことを示します。