Method: purchases.subscriptionsv2.get

subscriptionsv2.get metadata about a subscription

HTTP 要求

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
packageName

string

購買此訂閱項目的應用程式套件 (例如「com.some.thing」)。
token

string

必要欄位。購買訂閱項目時提供給使用者裝置的權杖。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 SubscriptionPurchaseV2 的執行例項。

範例

以下是要求範例：

curl -X GET \   'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptionsv2/tokens/sample-token-123' \   -H 'Accept: application/json' \   -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'

以下是回應範例：

{   "kind": "androidpublisher#subscriptionPurchaseV2",   "regionCode": "US",   "startTime": "2024-01-15T10:00:00Z",   "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",   "latestOrderId": "GPA.3345-1234-5678-90123",   "linkedPurchaseToken": null,   "pausedStateContext": null,   "canceledStateContext": null,   "testPurchase": null,   "acknowledgementState": "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED",   "externalAccountIdentifiers": {     "externalAccountId": "user-ext-acc-88765",     "obfuscatedExternalAccountId": " obfuscated-acc-id-aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",     "obfuscatedExternalProfileId": "obfuscated-prof-id-9876543210zYxWvUtSrQpOnMlKjIhGfEdCbA"   },   "subscribeWithGoogleInfo": {     "profileId": "109876543210987654321",     "profileName": "Alex Smith",     "emailAddress": "[email protected]",     "givenName": "Alex",     "familyName": "Smith"   },   "lineItems": [     {       "productId": "premium_monthly_v2",       "expiryTime": "2025-01-15T10:00:00Z",       "autoRenewingPlan": {         "autoRenewEnabled": true,         "recurringPrice": {           "units": "12",           "nanos": 990000000,           "currencyCode": "USD"         },         "priceChangeDetails": null,         "installmentDetails": null       },       "prepaidPlan": null,       "offerDetails": {         "basePlanId": "premium-monthly",         "offerId": "intro-offer-7day",         "offerTags": [           "initial_discount",           "seasonal_promo"         ]       },       "deferredItemReplacement": null,       "signupPromotion": null     }   ] }

授權範圍

需要下列 OAuth 範圍：

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