Method: purchases.subscriptions.acknowledge

定期購入を承認します。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
packageName

string

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

string

注: 2025 年 5 月 21 日以降、subscriptionId は必須ではなくなり、アドオン付きのサブスクリプションには推奨されなくなりました。購入した定期購入の ID（例: 「monthly001」）。
token

string

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

リクエストの本文

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

JSON 表現 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
フィールド
developerPayload

string

購入に付加するペイロード。
externalAccountIds

object (ExternalAccountIds)

省略可。アプリ内のユーザー アカウントの識別子。

レスポンスの本文

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

サンプル

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

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "developerPayload": "AppSpecificInfo-UserID-12345"
  }'

認可スコープ

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

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

ExternalAccountIds

アプリ内のユーザー アカウントの識別子。

JSON 表現 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
フィールド
obfuscatedAccountId

string

省略可。アプリ内の購入者のユーザー アカウントと一意に関連付けられた難読化文字列（省略可）を指定します。

この値が渡されると、Google Play は、異常なアクティビティを検出することができます。このフィールドを使用してメールアドレスなどの個人情報（PII）を平文で保存しないでください。このフィールドに PII を保存しようとすると、購入がブロックされます。Google Play では、暗号化または一方向ハッシュを使用して、Google Play に送信する難読化された ID を生成することをおすすめします。

この識別子は 64 文字に制限されています。

このフィールドは、再定期購入での購入にのみ設定できます。標準のアプリ内課金フローを使用して処理された購入についてこのフィールドを設定するには、https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid をご覧ください。
obfuscatedProfileId

string

省略可。アプリ内の購入者のユーザー プロファイルに一意に関連付けられた難読化文字列（省略可）を指定します。

この値が渡されると、Google Play は、異常なアクティビティを検出することができます。このフィールドを使用してメールアドレスなどの個人情報（PII）を平文で保存しないでください。このフィールドに PII を保存しようとすると、購入がブロックされます。Google Play では、暗号化または一方向ハッシュを使用して、Google Play に送信する難読化された ID を生成することをおすすめします。

この識別子は 64 文字に制限されています。

このフィールドは、再定期購入での購入にのみ設定できます。標準のアプリ内課金フローを使用して処理された購入でこのフィールドを設定するには、https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid をご覧ください。