Google Android Users API

The Users API from Google Android — 5 operation(s) for users.

GitHub OpenAPI

Operations 9

GET /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}/availableProductSet Get available product set users #
PUT /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}/availableProductSet Set available product set users #
GET /androidenterprise/v1/enterprises/{enterpriseId}/users List users #
POST /androidenterprise/v1/enterprises/{enterpriseId}/users Insert users #
DELETE /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}/deviceAccess Revoke device access users #
DELETE /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId} Delete users #
PUT /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId} Update users #
GET /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId} Get users #
POST /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}/authenticationToken Generate authentication token users #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/google-android:google-android-users-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-android-users-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Google Play EMM Users API
  version: v1
  description: Generated from Google's published Discovery document for Google Play EMM API (androidenterprise v1, revision 20261110). 9 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://androidenterprise.googleapis.com
tags:
- name: Users
paths:
  /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}/availableProductSet:
    get:
      operationId: androidenterprise.users.getAvailableProductSet
      summary: Get available product set users
      description: Retrieves the set of products a user is entitled to access. **Note:** This item has been deprecated. New integrations cannot use this method and can refer to our new recommendations.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: userId
        in: path
        required: true
        description: The ID of the user.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductSet'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
    put:
      operationId: androidenterprise.users.setAvailableProductSet
      summary: Set available product set users
      description: Modifies the set of products that a user is entitled to access (referred to as *whitelisted* products). Only products that are approved or products that were previously approved (products with revoked approval) can be whitelisted. **Note:** This item has been deprecated. New integrations cannot use this method and can refer to our new recommendations.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: userId
        in: path
        required: true
        description: The ID of the user.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductSet'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductSet'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
  /androidenterprise/v1/enterprises/{enterpriseId}/users:
    get:
      operationId: androidenterprise.users.list
      summary: List users
      description: Looks up a user by primary email address. This is only supported for Google-managed users. Lookup of the id is not needed for EMM-managed users because the id is already returned in the result of the Users.insert call.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: email
        in: query
        required: true
        description: Required. The exact primary email address of the user to look up.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsersListResponse'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
    post:
      operationId: androidenterprise.users.insert
      summary: Insert users
      description: Creates a new EMM-managed user. The Users resource passed in the body of the request should include an accountIdentifier and an accountType. If a corresponding user already exists with the same account identifier, the user will be updated with the resource. In this case only the displayName field can be changed.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/User'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
  /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}/deviceAccess:
    delete:
      operationId: androidenterprise.users.revokeDeviceAccess
      summary: Revoke device access users
      description: Revokes access to all devices currently provisioned to the user. The user will no longer be able to use the managed Play store on any of their managed devices. This call only works with EMM-managed accounts.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: userId
        in: path
        required: true
        description: The ID of the user.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
  /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}:
    delete:
      operationId: androidenterprise.users.delete
      summary: Delete users
      description: Deleted an EMM-managed user.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: userId
        in: path
        required: true
        description: The ID of the user.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
    put:
      operationId: androidenterprise.users.update
      summary: Update users
      description: Updates the details of an EMM-managed user. Can be used with EMM-managed users only (not Google managed users). Pass the new details in the Users resource in the request body. Only the displayName field can be changed. Other fields must either be unset or have the currently active value.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: userId
        in: path
        required: true
        description: The ID of the user.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/User'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
    get:
      operationId: androidenterprise.users.get
      summary: Get users
      description: Retrieves a user's details.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: userId
        in: path
        required: true
        description: The ID of the user.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
  /androidenterprise/v1/enterprises/{enterpriseId}/users/{userId}/authenticationToken:
    post:
      operationId: androidenterprise.users.generateAuthenticationToken
      summary: Generate authentication token users
      description: Generates an authentication token which the device policy client can use to provision the given EMM-managed user account on a device. The generated token is single-use and expires after a few minutes. You can provision a maximum of 10 devices per user. This call only works with EMM-managed accounts.
      parameters:
      - name: enterpriseId
        in: path
        required: true
        description: The ID of the enterprise.
        schema:
          type: string
      - name: userId
        in: path
        required: true
        description: The ID of the user.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationToken'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidenterprise
      - apiKey: []
      tags:
      - Users
components:
  schemas:
    ProductSet:
      description: A set of products.
      properties:
        productId:
          description: The list of product IDs making up the set of products.
          type: array
          items:
            type: string
        productVisibility:
          description: Additional list of product IDs making up the product set. Unlike the productID array, in this list It's possible to specify which tracks (alpha, beta, production) of a product are visible to the user. See ProductVisibility and its fields for more information. Specifying the same product ID both here and in the productId array is not allowed and it will result in an error.
          items:
            $ref: '#/components/schemas/ProductVisibility'
          type: array
        productSetBehavior:
          enum:
          - unknown
          - whitelist
          - includeAll
          - allApproved
          type: string
          description: The interpretation of this product set. "unknown" should never be sent and is ignored if received. "whitelist" means that the user is entitled to access the product set. "includeAll" means that all products are accessible, including products that are approved, products with revoked approval, and products that have never been approved. "allApproved" means that the user is entitled to access all products that are approved for the enterprise. If the value is "allApproved" or "includeAll", the productId field is ignored. If no value is provided, it is interpreted as "whitelist" for backwards compatibility. Further "allApproved" or "includeAll" does not enable automatic visibility of "alpha" or "beta" tracks for Android app. Use ProductVisibility to enable "alpha" or "beta" tracks per user.
      type: object
    User:
      description: 'A Users resource represents an account associated with an enterprise. The account may be specific to a device or to an individual user (who can then use the account across multiple devices). The account may provide access to managed Google Play only, or to other Google services, depending on the identity model: - The Google managed domain identity model requires synchronization to Google account sources (via primaryEmail). - The managed Google Play Accounts identity model provides a dynamic means for enterprises to create user or device accounts as needed. These accounts provide access to managed Google Play. '
      type: object
      properties:
        managementType:
          type: string
          description: The entity that manages the user. With googleManaged users, the source of truth is Google so EMMs have to make sure a Google Account exists for the user. With emmManaged users, the EMM is in charge.
          enum:
          - googleManaged
          - emmManaged
        id:
          description: The unique ID for the user.
          type: string
        accountType:
          type: string
          enum:
          - deviceAccount
          - userAccount
          description: The type of account that this user represents. A userAccount can be installed on multiple devices, but a deviceAccount is specific to a single device. An EMM-managed user (emmManaged) can be either type (userAccount, deviceAccount), but a Google-managed user (googleManaged) is always a userAccount.
        primaryEmail:
          type: string
          description: The user's primary email address, for example, "jsmith@example.com". Will always be set for Google managed users and not set for EMM managed users.
        accountIdentifier:
          type: string
          description: A unique identifier you create for this user, such as "user342" or "asset#44418". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users.
        displayName:
          type: string
          description: The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as "Example, Inc.") or your name (as EMM). Not used for Google-managed user accounts. @mutable androidenterprise.users.update
    ProductVisibility:
      type: object
      description: A product to be made visible to a user.
      properties:
        tracks:
          description: Deprecated. Use trackIds instead.
          type: array
          items:
            type: string
            enum:
            - appTrackUnspecified
            - production
            - beta
            - alpha
        productId:
          type: string
          description: The product ID to make visible to the user. Required for each item in the productVisibility list.
        trackIds:
          description: Grants the user visibility to the specified product track(s), identified by trackIds.
          type: array
          items:
            type: string
    UsersListResponse:
      type: object
      properties:
        user:
          items:
            $ref: '#/components/schemas/User'
          description: A user of an enterprise.
          type: array
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    AuthenticationToken:
      description: An AuthenticationToken is used by the EMM's device policy client on a device to provision the given EMM-managed user on that device.
      properties:
        token:
          type: string
          description: The authentication token to be passed to the device policy client on the device where it can be used to provision the account for which this token was generated.
      type: object
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/androidenterprise: Manage corporate Android devices
externalDocs:
  url: https://developers.google.com/android/work/play/emm-api
x-provenance:
  method: harvested
  publisher: Google
  source: https://androidenterprise.googleapis.com/$discovery/rest?version=v1
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261110)