Important: We are no longer accepting new registrations for the Play EMM API. Learn more.

Products: list

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:

Scope
`https://www.googleapis.com/auth/androidenterprise`

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "androidenterprise#productsListResponse",
  "pageInfo": {
    "totalResults": integer,
    "resultPerPage": integer,
    "startIndex": integer
  },
  "tokenPagination": {
    "nextPageToken": string,
    "previousPageToken": string
  },
  "product": [
    products Resource
  ]
}

Property name	Value	Description
`tokenPagination`	`nested object`	Pagination information for token pagination.
`tokenPagination.nextPageToken`	`string`
`product[]`	`list`	Information about a product (e.g. an app) in the Google Play store, for display to an enterprise admin.
`pageInfo`	`nested object`	General pagination information.
`pageInfo.totalResults`	`integer`
`pageInfo.resultPerPage`	`integer`
`pageInfo.startIndex`	`integer`
`tokenPagination.previousPageToken`	`string`
`kind`	`string`	Identifies what kind of resource this is. Value: the fixed string `"androidenterprise#productsListResponse"`.