Stay organized with collectionsSave and categorize content based on your preferences.
Finds approved products that match a query, or all approved products
if there is no query.
Request
HTTP request
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/products
Parameters
Parameter name
Value
Description
Path parameters
enterpriseId
string
The ID of the enterprise.
Optional query parameters
approved
boolean
Specifies whether to search among all products (false) or among
only products that have been approved (true). Only "true" is
supported, and should be specified.
language
string
The BCP47 tag for the user's preferred language (e.g. "en-US", "de").
Results are returned in the language best matching the preferred
language.
maxResults
unsigned integer
Specifies the maximum number of products that can be returned per request. If not specified, uses a default value of 100, which is also the maximum retrievable within a single response.
query
string
The search query as typed in the Google Play store search box.
If omitted, all approved apps will be returned (using the pagination
parameters), including apps that are not available in the store
(e.g. unpublished apps).
token
string
A pagination token is contained in a request's response when there are more products. The token can be used in a subsequent request to obtain more products, and so forth. This parameter cannot be used in the initial request.
Authorization
This request requires authorization with the following scope:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["\u003cp\u003eThis method retrieves approved products from the Google Play store for an enterprise, either all or based on a search query.\u003c/p\u003e\n"],["\u003cp\u003eIt is deprecated and will be inaccessible after September 30, 2025; new integrations should refer to the recommended alternative.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003ePagination is supported for retrieving large result sets using tokens.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes product information, pagination details, and a kind identifier.\u003c/p\u003e\n"]]],[],null,["# Products: list\n\n| **Note:** Requires [authorization](#auth).\n\n\u003cbr /\u003e\n\n| **Deprecated:** New integrations cannot use this method and can refer to our [new\n| recommendations](/android/work/deprecations#recommended_alternative). \n| **This method will no longer be accessible by\n| anyone after September 30, 2025.**\nFinds approved products that match a query, or all approved products if there is no query.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/products\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| **Optional query parameters** |||\n| `approved` | `boolean` | Specifies whether to search among all products (false) or among only products that have been approved (true). Only \"true\" is supported, and should be specified. |\n| `language` | `string` | The BCP47 tag for the user's preferred language (e.g. \"en-US\", \"de\"). Results are returned in the language best matching the preferred language. |\n| `maxResults` | `unsigned integer` | Specifies the maximum number of products that can be returned per request. If not specified, uses a default value of 100, which is also the maximum retrievable within a single response. |\n| `query` | `string` | The search query as typed in the Google Play store search box. If omitted, all approved apps will be returned (using the pagination parameters), including apps that are not available in the store (e.g. unpublished apps). |\n| `token` | `string` | A pagination token is contained in a request's response when there are more products. The token can be used in a subsequent request to obtain more products, and so forth. This parameter cannot be used in the initial request. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"androidenterprise#productsListResponse\",\n \"pageInfo\": {\n \"totalResults\": integer,\n \"resultPerPage\": integer,\n \"startIndex\": integer\n },\n \"tokenPagination\": {\n \"nextPageToken\": string,\n \"previousPageToken\": string\n },\n \"product\": [\n products Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------|-------|\n| `tokenPagination` | `nested object` | Pagination information for token pagination. | |\n| tokenPagination.`nextPageToken` | `string` | | |\n| `product[]` | `list` | Information about a product (e.g. an app) in the Google Play store, for display to an enterprise admin. | |\n| `pageInfo` | `nested object` | General pagination information. | |\n| pageInfo.`totalResults` | `integer` | | |\n| pageInfo.`resultPerPage` | `integer` | | |\n| pageInfo.`startIndex` | `integer` | | |\n| tokenPagination.`previousPageToken` | `string` | | |\n| `kind` | `string` | Identifies what kind of resource this is. Value: the fixed string `\"androidenterprise#productsListResponse\"`. | |"]]
