subscriptionsv2.get metadata about a subscription
HTTP 要求
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
packageName |
購買此訂閱項目的應用程式套件 (例如「com.some.thing」)。 |
token |
必要欄位。購買訂閱項目時提供給使用者裝置的權杖。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體會包含 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": "alex.smith.swg@example.com", "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