Google Android Permissions API

openapi: 3.2.0
info:
  title: Google Play EMM Permissions API
  version: v1
  description: Generated from Google's published Discovery document for Google Play EMM API (androidenterprise v1, revision 20261110). 1 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://androidenterprise.googleapis.com
tags:
- name: Permissions
paths:
  /androidenterprise/v1/permissions/{permissionId}:
    get:
      operationId: androidenterprise.permissions.get
      summary: Get permissions
      description: Retrieves details of an Android app permission for display to an enterprise admin.
      parameters:
      - name: permissionId
        in: path
        required: true
        description: The ID of the permission.
        schema:
          type: string
      - name: language
        in: query
        required: false
        description: The BCP47 tag for the user's preferred language (e.g. "en-US", "de")
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Permission'
        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:
      - Permissions
components:
  schemas:
    Permission:
      properties:
        name:
          type: string
          description: The name of the permission.
        permissionId:
          type: string
          description: An opaque string uniquely identifying the permission.
        description:
          description: A longer description of the Permissions resource, giving more details of what it affects.
          type: string
      type: object
      description: A Permissions resource represents some extra capability, to be granted to an Android app, which requires explicit consent. An enterprise admin must consent to these permissions on behalf of their users before an entitlement for the app can be created. The permissions collection is read-only. The information provided for each permission (localized name and description) is intended to be used in the MDM user interface when obtaining consent from the enterprise.
    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
  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)