Esta referencia de la API está organizada por tipo de recurso. Cada tipo de recurso tiene una o más representaciones de datos y uno o más métodos.
Tipos de recursos
- Dispositivos
- Empresas
- Derechos
- Licencias grupales
- Usuarios con licencia del grupo
- Instalaciones
- Managedconfigurationsfordevice
- Configuración administrada para el usuario
- Managedconfigurationssettings
- Permisos
- Productos
- Serviceaccountkeys
- Storelayoutclusters
- Storelayoutpages
- Usuarios
- Apps web
Dispositivos
Para obtener más información sobre los recursos de dispositivos, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| forceReportUpload |
POST /enterprises/enterpriseId/users/userId/devices/deviceId/forceReportUpload
|
Sube un informe con los cambios de estado de la app en el dispositivo desde se generó el último informe. Puedes llamar a este método hasta 3 veces cada 24 horas para un dispositivo determinado. |
| get |
GET /enterprises/enterpriseId/users/userId/devices/deviceId
|
Recupera los detalles de un dispositivo. |
| getState |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/state
|
Recupera si el acceso de un dispositivo a los servicios de Google está habilitado o inhabilitado. El estado del dispositivo solo se aplica si se aplican políticas de EMM en Android esté habilitado en la Consola del administrador de Google. De lo contrario, se ignorará el estado del dispositivo y todos los dispositivos podrán acceder. a los servicios de Google. Esta opción solo se admite para los usuarios administrados por Google. |
| list |
GET /enterprises/enterpriseId/users/userId/devices
|
Recupera los ID de todos los dispositivos de un usuario. |
| setState |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/state
|
Establece si se habilita o inhabilita el acceso de un dispositivo a los servicios de Google. El estado del dispositivo solo se aplica si se aplican políticas de EMM en Android esté habilitado en la Consola del administrador de Google. De lo contrario, se ignorará el estado del dispositivo y todos los dispositivos podrán acceder. a los servicios de Google. Esta opción solo se admite para los usuarios administrados por Google. |
| actualización |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId
|
Actualiza la política de dispositivo.
Para asegurarte de que la política se aplique correctamente, debes impedir que las aplicaciones accedan a Google Play estableciendo la allowed_accounts en la configuración administrada de la
Paquete de Play. Consulta la restricción
en Google Play.
|
Empresas
Para conocer los detalles de los recursos para empresas, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| acknowledgeNotificationSet |
POST /enterprises/acknowledgeNotificationSet
|
Reconoce las notificaciones que se recibieron de Enterprises.PullNotificationSet para evitar que se devuelvan llamadas posteriores las mismas notificaciones. |
| completeSignup |
POST /enterprises/completeSignup
|
Completa el flujo de registro especificando el token de finalización y Token empresarial. No se debe llamar a esta solicitud varias veces para una determinada empresa Token. |
| createWebToken |
POST /enterprises/enterpriseId/createWebToken
|
Devuelve un token único para acceder a una IU integrable. Para generar un IU web, pasar el token generado al código JavaScript de Google Play administrado en la API de Cloud. Cada token solo se puede usar para iniciar una sesión de IU. Consulta la Documentación de la API de JavaScript para obtener más información. |
| inscribirse |
POST /enterprises/enroll
|
Inscribe una empresa con el EMM que realiza la llamada.
Parámetros de consulta obligatorios:
|
| generateSignupUrl |
POST /enterprises/signupUrl
|
Genera una URL de registro. |
| get |
GET /enterprises/enterpriseId
|
Recupera el nombre y el dominio de una empresa. |
| getServiceAccount |
GET /enterprises/enterpriseId/serviceAccount
|
Muestra una cuenta de servicio y credenciales. La cuenta de servicio
pueden vincularse a una empresa llamando a setAccount. La cuenta de servicio
es exclusiva de esta empresa y de EMM, y se borrará si la empresa
no está delimitado. Las credenciales contienen datos de clave privada y no se almacenan
del servidor.
: Solo se puede llamar a este método después de llamar Enterprises.enroll o Enterprises.CompleteSignup, y antes Enterprises.SetAccount; otras, se mostrará un error. : Las llamadas subsiguientes después de la primera generarán un conjunto nuevo y único de las credenciales y, luego, invalidar las que se generaron con anterioridad. : Una vez que la cuenta de servicio esté vinculada a la empresa, se podrá administrar con el recurso serviceAccountKeys. |
| getStoreLayout |
GET /enterprises/enterpriseId/storeLayout
|
Muestra el diseño de la tienda para la empresa. Si el diseño de la tienda no se estableció, el resultado es “basic” como el tipo de diseño de tienda y no página principal. |
| list |
GET /enterprises
|
Busca una empresa por nombre de dominio.
Esto solo está disponible para empresas creadas a través de la herramienta iniciada por Google
de tu flujo de creación. La búsqueda del ID no es necesaria para empresas creadas a través de
el flujo iniciado por EMM, ya que este aprende el ID de la empresa del
la devolución de llamada especificada en la llamada Enterprises.generateSignupUrl.
Parámetros de consulta obligatorios:
|
| pullNotificationSet |
POST /enterprises/pullNotificationSet
|
Extrae y muestra un conjunto de notificaciones para las empresas asociadas con
la cuenta de servicio autenticada para la solicitud. La notificación establecida puede
estará vacío si no hay notificaciones pendientes.
Un conjunto de notificaciones que se muestra debe confirmarse en un plazo de 20 segundos llamando a Enterprises.AcknowledgeNotificationSet, a menos que el conjunto de notificaciones está vacío. Las notificaciones que no se acepten dentro de los 20 segundos en la respuesta a otro PullNotificationSet solicitud, y las que nunca se reconocen se borrarán en última instancia según la política del sistema de Pub/Sub de Google Cloud. Se pueden realizar varias solicitudes de forma simultánea para recuperar notificaciones, en cuyo caso las notificaciones pendientes (si las hay) se dividida entre cada emisor, si hay alguno pendiente. Si no hay notificaciones, se muestra una lista vacía. Es posible que en las solicitudes posteriores se devuelvan más notificaciones una vez que se disponibles. |
| sendTestPushNotification |
POST /enterprises/enterpriseId/sendTestPushNotification
|
Se envía una notificación de prueba para validar la integración de EMM. el servicio de Pub/Sub de Google Cloud para esta empresa. |
| setAccount |
PUT /enterprises/enterpriseId/account
|
Establece la cuenta que se usará para autenticarse en la API como el . |
| setStoreLayout |
PUT /enterprises/enterpriseId/storeLayout
|
Establece el diseño de la tienda para la empresa. De forma predeterminada, storeLayoutType está establecido en "básico" y el diseño básico de la tienda está habilitado. Aspectos básicos el diseño solo contiene apps aprobadas por el administrador y que tienen al conjunto de productos disponible para un usuario (mediante el setAvailableProductSet). Las apps de la página se ordenan según lo siguiente: su valor de ID del producto. Si creas un diseño de tienda personalizado (estableciendo storeLayoutType = "personalizado" y establecer una página de inicio), el almacén básico el diseño está inhabilitado. |
| dar de baja |
POST /enterprises/enterpriseId/unenroll
|
Da de baja una empresa al EMM que realiza la llamada. |
Autorizaciones
Para obtener más información sobre los recursos de derechos, consulta la página de representación de los recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
Quita una autorización de una app para un usuario. |
| get |
GET /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
Recupera los detalles de una autorización. |
| list |
GET /enterprises/enterpriseId/users/userId/entitlements
|
Muestra una lista de todos los derechos del usuario especificado. Solo se establece el ID. |
| actualización |
PUT /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
Agrega o actualiza derechos de un usuario en una app. |
Licencias grupales
Para conocer los detalles del recurso Grouplicenses, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| get |
GET /enterprises/enterpriseId/groupLicenses/groupLicenseId
|
Recupera los detalles de la licencia grupal de una empresa de un producto. |
| list |
GET /enterprises/enterpriseId/groupLicenses
|
Recupera los ID de todos los productos para los que la empresa tiene una licencia grupal. |
Usuarios con licencia del grupo
Para conocer los detalles del recurso Grouplicenseusers, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| list |
GET /enterprises/enterpriseId/groupLicenses/groupLicenseId/users
|
Recupera los ID de los usuarios a los que se les otorgaron derechos. en virtud de la licencia. |
Instalaciones
Para conocer los detalles del recurso de instalaciones, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
Solicitudes para quitar una app de un dispositivo Una llamada a get o
list seguirá mostrando la app como instalada en el dispositivo hasta que
se elimina realmente.
|
| get |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
Recupera los detalles de una instalación de una app en un dispositivo. |
| list |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/installs
|
Recupera los detalles de todas las apps instaladas en el dispositivo especificado. |
| actualización |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
Solicitudes para instalar la versión más reciente de una app en un dispositivo. Si la aplicación ya está instalada, se actualizará a la última versión si necesario. |
Managedconfigurationsfordevice
Para obtener más información sobre el recurso Managedconfigurationsfordevice, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
Quita una configuración administrada por dispositivo de una app para el valor especificado dispositivo. |
| get |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
Recupera detalles de una configuración administrada por dispositivo. |
| list |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice
|
Enumera todas las configuraciones administradas por dispositivo para el dispositivo especificado. Solo se establece el ID. |
| actualización |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
Agrega o actualiza una configuración administrada por dispositivo de una app para el dispositivo especificado. |
Configuración administrada para el usuario
Para obtener más información sobre el recurso Managedconfigurationsforuser, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
Quita una configuración administrada por usuario de una app para el valor especificado usuario. |
| get |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
Recupera detalles de una configuración administrada por usuario de una app para usuario especificado. |
| list |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser
|
Muestra una lista de todas las configuraciones administradas por usuario para el usuario especificado. Solo se establece el ID. |
| actualización |
PUT /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
Agrega o actualiza los parámetros de configuración administrados de una app para el usuario especificado.
Si admites el iframe de configuraciones administradas,
puedes aplicar configuraciones administradas a un usuario especificando un mcmId
y sus variables de configuración asociadas (si las hubiera) en la solicitud. Por otro lado,
todos los EMM pueden aplicar configuraciones administradas pasando una lista de
propiedades.
|
Managedconfigurationssettings
Para obtener más información sobre el recurso Managedconfigurationssettings, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| list |
GET /enterprises/enterpriseId/products/productId/managedConfigurationsSettings
|
Muestra una lista de todos los parámetros de configuración administrados de la app especificada. |
Permisos
Para obtener más información sobre los recursos de permisos, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| get |
GET /permissions/permissionId
|
Recupera los detalles de un permiso de app para Android para mostrárselos a un administrador empresarial. |
Productos
Para obtener más información sobre los recursos de productos, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| aprobar |
POST /enterprises/enterpriseId/products/productId/approve
|
Aprueba el producto especificado y los permisos relevantes de la app, si los hay. La cantidad máxima de productos que puede aprobar por cliente empresarial es 1,000. Para aprender a usar Google Play administrado para diseñar y crear una tienda para mostrar los productos aprobados a los usuarios, consulta Diseño de tienda. |
| generateApprovalUrl |
POST /enterprises/enterpriseId/products/productId/generateApprovalUrl
|
Genera una URL que se puede renderizar en un iframe para mostrar el
permisos (si los hay) de un producto. Un administrador empresarial debe verlos
permisos y aceptarlos en nombre de su organización para
aprobar el producto. Los administradores deben aceptar los permisos que se muestran interactuando con un elemento de la IU separado en la consola de EMM, que, a su vez, debería activar el uso de esta URL como el La propiedad approvalUrlInfo.approvalUrl en una
Products.approve llamada para aprobar el producto.
Esta URL solo se puede usar para mostrar los permisos durante 1 día como máximo.
|
| get |
GET /enterprises/enterpriseId/products/productId
|
Recupera detalles de un producto para mostrar a un administrador empresarial. |
| getAppRestrictionsSchema |
GET /enterprises/enterpriseId/products/productId/appRestrictionsSchema
|
Recupera el esquema que define las propiedades configurables de esta producto. Todos los productos tienen un esquema, pero este puede estar vacío si no hay de configuraciones administradas. Este esquema puede usarse para para propagar una IU que permita al administrador configurar el producto. Para aplicar una configuración administrada según el esquema obtenido con este en la API, consulta Configuraciones administradas a través de Play |
| getPermissions |
GET /enterprises/enterpriseId/products/productId/permissions
|
Recupera los permisos de las apps para Android que requiere esta app. |
| list |
GET /enterprises/enterpriseId/products
|
Encuentra productos aprobados que coinciden con una búsqueda, o bien todos los productos aprobados si no hay una consulta. |
| no aprobar |
POST /enterprises/enterpriseId/products/productId/unapprove
|
Anular la aprobación del producto especificado (y los permisos relevantes de la app, si los hubiera) |
Serviceaccountkeys
Para obtener más información sobre los recursos Serviceaccountkeys, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/serviceAccountKeys/keyId
|
Quita y, luego, invalida las credenciales especificadas para la cuenta de servicio asociadas a esta empresa. La cuenta de servicio de llamadas debe haberse se recuperan llamando a Enterprises.GetServiceAccount como la cuenta de servicio empresarial llamando a Enterprises.SetAccount. |
| insertar |
POST /enterprises/enterpriseId/serviceAccountKeys
|
Genera credenciales nuevas para la cuenta de servicio asociada con esta
. La cuenta de servicio de llamadas debe haberse recuperado llamando
Enterprises.GetServiceAccount y se debe haber establecido como la cuenta
de servicio llamando a Enterprises.SetAccount. Solo el tipo de clave debe completarse en el recurso que se se insertó. |
| list |
GET /enterprises/enterpriseId/serviceAccountKeys
|
Muestra una lista de todas las credenciales activas de la cuenta de servicio asociada con esta. . Solo se muestran el ID y el tipo de clave. El servicio de llamadas la cuenta se debe haber recuperado llamando a Enterprises.GetServiceAccount y debe haberse establecido como la cuenta de servicio empresarial llamando Enterprises.SetAccount. |
Storelayoutclusters
Para obtener los detalles del recurso Storelayoutclusters, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
Borra un clúster. |
| get |
GET /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
Recupera los detalles de un clúster. |
| insertar |
POST /enterprises/enterpriseId/storeLayout/pages/pageId/clusters
|
Inserta un clúster nuevo en una página. |
| list |
GET /enterprises/enterpriseId/storeLayout/pages/pageId/clusters
|
Recupera los detalles de todos los clústeres de la página especificada. |
| actualización |
PUT /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
Actualiza un clúster. |
Storelayoutpages
Para obtener los detalles del recurso Storelayoutpages, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/storeLayout/pages/pageId
|
Borra una página de la tienda. |
| get |
GET /enterprises/enterpriseId/storeLayout/pages/pageId
|
Recupera los detalles de una página de tienda. |
| insertar |
POST /enterprises/enterpriseId/storeLayout/pages
|
Inserta una nueva página de tienda. |
| list |
GET /enterprises/enterpriseId/storeLayout/pages
|
Recupera los detalles de todas las páginas de la tienda. |
| actualización |
PUT /enterprises/enterpriseId/storeLayout/pages/pageId
|
Actualiza el contenido de una página de la tienda. |
Usuarios
Para obtener más información sobre los recursos de usuarios, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/users/userId
|
Borraste un usuario administrado por EMM. |
| generateAuthenticationToken |
POST /enterprises/enterpriseId/users/userId/authenticationToken
|
Genera un token de autenticación que el cliente de política de dispositivo puede usar para
aprovisionar la cuenta de usuario administrada por EMM en un dispositivo.
El token generado es de un solo uso y expira después de unos minutos.
Puedes aprovisionar un máximo de 10 dispositivos por usuario. Esta llamada solo funciona con cuentas administradas por EMM. |
| get |
GET /enterprises/enterpriseId/users/userId
|
Recupera los detalles de un usuario. |
| getAvailableProductSet |
GET /enterprises/enterpriseId/users/userId/availableProductSet
|
Recupera el conjunto de productos a los que un usuario tiene derecho a acceder. |
| insertar |
POST /enterprises/enterpriseId/users
|
Crea un nuevo usuario administrado por EMM.
El recurso Users pasado en el cuerpo de la solicitud debe incluir un accountIdentifier y un accountType.
Si ya existe un usuario con el mismo identificador de cuenta,
el usuario se actualizará con el recurso. En este caso, solo el
Se puede cambiar el campo |
| list |
GET /enterprises/enterpriseId/users
|
Busca un usuario por su dirección de correo electrónico principal.
Esta opción solo se admite para los usuarios administrados por Google. La búsqueda del ID no es
necesario para los usuarios administrados por EMM porque el ID ya se devuelve
resultado de la llamada Users.insert.
Parámetros de consulta obligatorios:
|
| revokeDeviceAccess |
DELETE /enterprises/enterpriseId/users/userId/deviceAccess
|
Revoca el acceso a todos los dispositivos aprovisionados actualmente al usuario. El usuario
ya no podrán usar Play Store administrado en ninguno de sus
en dispositivos administrados.
Esta llamada solo funciona con cuentas administradas por EMM. |
| setAvailableProductSet |
PUT /enterprises/enterpriseId/users/userId/availableProductSet
|
Modifica el conjunto de productos a los que un usuario tiene derecho a acceder (en adelante, como productos incluidos en la lista blanca). Solo los productos que son aprobado o productos aprobados previamente (productos con aprobación revocada) se pueden incluir en la lista blanca. |
| actualización |
PUT /enterprises/enterpriseId/users/userId
|
Actualiza los detalles de un usuario administrado por EMM.
Solo se puede usar con usuarios administrados por EMM (no con usuarios administrados por Google). Pasa los nuevos detalles en la Usuarios recurso en el cuerpo de la solicitud. Solo el campo displayName
que se puede cambiar. Otros campos deben estar desactivados o tener la
valor activo actualmente.
|
Apps web
Para obtener más información sobre los recursos de apps web, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/androidenterprise/v1, a menos que se indique lo contrario | ||
| borrar |
DELETE /enterprises/enterpriseId/webApps/webAppId
|
Borra una app web existente. |
| get |
GET /enterprises/enterpriseId/webApps/webAppId
|
Obtiene una app web existente. |
| insertar |
POST /enterprises/enterpriseId/webApps
|
Crea una app web nueva para la empresa. |
| list |
GET /enterprises/enterpriseId/webApps
|
Recupera los detalles de todas las aplicaciones web de una empresa determinada. |
| actualización |
PUT /enterprises/enterpriseId/webApps/webAppId
|
Actualiza una app web existente. |