Method: purchases.subscriptions.acknowledge

• HTTP リクエスト
• パスパラメータ
• リクエストの本文
  • JSON 表現
• レスポンスの本文
• 認可スコープ
• 試してみる

定期購入を承認します。

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 }

フィールド
developerPayload	string 購入にアタッチされているペイロード。

レスポンスの本文

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

サンプル

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

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