Method: purchases.subscriptionsv2.get

关于订阅的 subscriptionsv2.get 元数据

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