Method: purchases.subscriptions.cancel

非推奨: 代わりに purchases.subscriptionsv2.cancel を使用してください。ユーザーの定期購入を解約します。定期購入は有効期限まで有効です。クライアント ライブラリのサポートを強化した新しいバージョンは、purchases.subscriptionsv2.cancel で入手できます。

HTTP リクエスト

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
packageName

string

この定期購入が購入されたアプリのパッケージ名（例: 'com.some.thing'）。
subscriptionId

string

注: 2025 年 5 月 21 日以降、subscriptionId は必須ではなくなり、アドオン付きの定期購入には推奨されません。購入した定期購入の ID（例: 'monthly001'）。
token

string

定期購入の購入時にユーザーのデバイスに提供されたトークン。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "cancellationType": enum (CancellationType)
}
フィールド
cancellationType

enum (CancellationType)

省略可。購入した定期購入のキャンセルの種類。このフィールドは HTTP リクエストでのみサポートされています。クライアント ライブラリでは使用できません。クライアント ライブラリのユーザーは、代わりに purchases.subscriptionsv2.cancel を使用できます。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

サンプル

リクエストの例を次に示します。

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/androidpublisher

CancellationType

デベロッパーがリクエストしたキャンセルの種類。

列挙型
CANCELLATION_TYPE_UNSPECIFIED キャンセルの種類が未指定。
USER_REQUESTED_STOP_RENEWALS ユーザーがリクエストしたキャンセル。定期購入は再開できます。定期購入の次回の更新のみが停止されます。分割払いの定期購入の場合、ユーザーは契約期間を終了する必要があります。更新とお支払いについて詳しくは、https://developer.android.com/google/play/billing/subscriptions#installments をご覧ください。
DEVELOPER_REQUESTED_STOP_PAYMENTS デベロッパーがリクエストしたキャンセル。定期購入は再開できません。定期購入の次回の支払いが停止されます。分割払いの定期購入の場合、ユーザーは次回の支払いを済ませて契約期間を終了する必要はありません。更新とお支払いについて詳しくは、https://developer.android.com/google/play/billing/subscriptions#installments をご覧ください。キャンセルの種類が指定されていない場合、これがデフォルトの動作になります。