Method: purchases.subscriptionsv2.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Metadatos de subscriptionsv2.get sobre una suscripción
Solicitud HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
packageName |
string
Es el paquete de la aplicación para la que se compró la suscripción (por ejemplo, "com.algo.algo").
|
token |
string
Obligatorio. Es el token que se proporcionó al dispositivo del usuario cuando se compró la suscripción.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de SubscriptionPurchaseV2.
Muestra
La siguiente es una solicitud de ejemplo:
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>'
A continuación, se muestra una respuesta de ejemplo:
{
"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
}
]
}
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/androidpublisher
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 2025-07-26 (UTC)"],[[["\u003cp\u003eRetrieves metadata for a specific subscription purchase within a given application's package.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the application package name and the purchase token in the request URL.\u003c/p\u003e\n"],["\u003cp\u003eReturns detailed information about the subscription, such as purchase status, start/end times, and payment details, if successful.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is necessary using the \u003ccode\u003eandroidpublisher\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document outlines the process for retrieving metadata about a subscription using the `subscriptionsv2.get` method. This is done via a `GET` HTTP request to a specific URL containing the application's package name and a purchase token. The request body must be empty. The response, if successful, contains subscription details in the `SubscriptionPurchaseV2` format. This process requires the `https://www.googleapis.com/auth/androidpublisher` OAuth scope for authorization. The path parameters are package name and token.\n"],null,["# Method: purchases.subscriptionsv2.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nsubscriptionsv2.get metadata about a subscription\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|--------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` The package of the application for which this subscription was purchased (for example, 'com.some.thing'). |\n| `token` | `string` Required. The token provided to the user's device when the subscription was purchased. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [SubscriptionPurchaseV2](/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2#SubscriptionPurchaseV2).\n\n### Sample\n\nThe following is a sample request: \n\n```json\ncurl -X GET \\\n 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptionsv2/tokens/sample-token-123' \\\n -H 'Accept: application/json' \\\n -H 'Authorization: Bearer \u003cYOUR_ACCESS_TOKEN\u003e'\n```\n\nThe following is a sample response: \n\n```json\n{\n \"kind\": \"androidpublisher#subscriptionPurchaseV2\",\n \"regionCode\": \"US\",\n \"startTime\": \"2024-01-15T10:00:00Z\",\n \"subscriptionState\": \"SUBSCRIPTION_STATE_ACTIVE\",\n \"latestOrderId\": \"GPA.3345-1234-5678-90123\",\n \"linkedPurchaseToken\": null,\n \"pausedStateContext\": null,\n \"canceledStateContext\": null,\n \"testPurchase\": null,\n \"acknowledgementState\": \"ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED\",\n \"externalAccountIdentifiers\": {\n \"externalAccountId\": \"user-ext-acc-88765\",\n \"obfuscatedExternalAccountId\": \" obfuscated-acc-id-aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"obfuscatedExternalProfileId\": \"obfuscated-prof-id-9876543210zYxWvUtSrQpOnMlKjIhGfEdCbA\"\n },\n \"subscribeWithGoogleInfo\": {\n \"profileId\": \"109876543210987654321\",\n \"profileName\": \"Alex Smith\",\n \"emailAddress\": \"alex.smith.swg@example.com\",\n \"givenName\": \"Alex\",\n \"familyName\": \"Smith\"\n },\n \"lineItems\": [\n {\n \"productId\": \"premium_monthly_v2\",\n \"expiryTime\": \"2025-01-15T10:00:00Z\",\n \"autoRenewingPlan\": {\n \"autoRenewEnabled\": true,\n \"recurringPrice\": {\n \"units\": \"12\",\n \"nanos\": 990000000,\n \"currencyCode\": \"USD\"\n },\n \"priceChangeDetails\": null,\n \"installmentDetails\": null\n },\n \"prepaidPlan\": null,\n \"offerDetails\": {\n \"basePlanId\": \"premium-monthly\",\n \"offerId\": \"intro-offer-7day\",\n \"offerTags\": [\n \"initial_discount\",\n \"seasonal_promo\"\n ]\n },\n \"deferredItemReplacement\": null,\n \"signupPromotion\": null\n }\n ]\n}\n```\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
