Method: monetization.subscriptions.list
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyświetla listę wszystkich subskrypcji w ramach danej aplikacji.
Żądanie HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
packageName | string
Wymagane. Aplikacja nadrzędna (nazwa pakietu), której subskrypcje mają być odczytywane. |
Parametry zapytania
| Parametry |
pageSize | integer
Maksymalna liczba subskrypcji do zwrotu. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 subskrypcji. Maksymalna wartość to 1000. wartości powyżej 1000 zostaną zmienione na 1000. |
pageToken | string
Token strony otrzymany z poprzedniego wywołania funkcji subscriptions.list. Podaj go, aby pobrać kolejną stronę. Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu subscriptions.list muszą być zgodne z wywołaniem, które dostarczyło token strony. |
showArchived
(deprecated) | boolean
Wycofano: archiwizacja subskrypcji nie jest obsługiwana. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Komunikat z odpowiedzią dotyczący pliku subscriptions.list.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{ "subscriptions": [ { object (Subscription) } ], "nextPageToken": string } |
| Pola |
subscriptions[] | object (Subscription)
Subskrypcje z określonej aplikacji. |
nextPageToken | string
Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/androidpublisher
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eLists all subscriptions under a given app using an HTTP GET request.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the app's package name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by page size and using pagination for large result sets.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of subscriptions with details and a token for accessing further pages.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to list subscriptions for a given Android application using the Android Publisher API. It uses a `GET` HTTP request to the specified URL, including a required `packageName` path parameter. Optional query parameters like `pageSize` and `pageToken` enable pagination. The request body must be empty. The response includes a list of subscriptions, represented in JSON, and a `nextPageToken` for subsequent pages. This operation requires the `androidpublisher` OAuth scope.\n"],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListSubscriptionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all subscriptions under a given app.\n\nHTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|---------------|----------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) for which the subscriptions should be read. |\n\nQuery parameters\n\n| Parameters ||\n|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of subscriptions to return. The service may return fewer than this value. If unspecified, at most 50 subscriptions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. |\n| `pageToken` | `string` A page token, received from a previous `subscriptions.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `subscriptions.list` must match the call that provided the page token. |\n| `showArchived` **(deprecated)** | `boolean` Deprecated: subscription archiving is not supported. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body Response message for subscriptions.list.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"subscriptions\": [ { object (/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| `subscriptions[]` | `object (`[Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription)`)` The subscriptions from the specified app. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
