Si quieres ver una lista de los métodos para este recurso, consulta la sección final de esta página.
Representaciones de recursos
Un recurso Enterprises representa la vinculación entre una EMM y una organización específica. Se puede crear una instancia de esa vinculación de una de dos maneras diferentes con esta API de la siguiente manera:
- Para los clientes de dominios administrados por Google, el proceso implica el uso de
Enterprises.enroll
yEnterprises.setAccount
(junto con artefactos obtenidos de la Consola del administrador y la Consola de APIs de Google) y enviados a EMM a través de un proceso manual, cada vez más o menos. - Para los clientes de cuentas de Google Play administradas, el proceso implica el uso de
Enterprises.generateSignupUrl
yEnterprises.completeSignup
junto con la IU de registro de Google Play administrado (mecanismo proporcionado por Google) para crear la vinculación sin pasos manuales.
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
administrator[] |
list |
Administradores de la empresa. Esta opción solo se admite en empresas creadas a través del flujo iniciado por EMM. |
|
administrator[].email |
string |
La dirección de correo electrónico del administrador. | |
id |
string |
El ID único de la empresa. |
|
kind |
string |
||
name |
string |
El nombre de la empresa; por ejemplo, "Example, Inc". | |
primaryDomain |
string |
El dominio principal de la empresa, como “example.com”. |
Métodos
- acknowledgeNotificationSet
- Reconoce las notificaciones que se recibieron de Enterprises.PullNotificationSet para evitar que las llamadas posteriores muestren las mismas notificaciones.
- completeSignup
- Completa el flujo de registro especificando el token de finalización y el token empresarial. No se debe llamar a esta solicitud varias veces para un token empresarial determinado.
- createWebToken
- Muestra un token único para acceder a una IU integrable. Para generar una IU web, pasa el token generado a la API de JavaScript de Google Play administrado. 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
- Inscribe una empresa con la EMM que realiza la llamada.
- generateSignupUrl
- Genera una URL de registro.
- get
- Recupera el nombre y dominio de una empresa.
- getServiceAccount
- Muestra una cuenta de servicio y credenciales. La cuenta de servicio se puede vincular a la empresa mediante una llamada a setAccount. La cuenta de servicio es exclusiva de esta empresa y EMM, y se borrará si la empresa no está vinculada. Las credenciales contienen datos de clave privada y no se almacenan en el servidor.
Solo se puede llamar a este método después de llamar a Enterprises.Enroll o Enterprises.CompleteSignup, y antes de Enterprises.SetAccount. En otras ocasiones, se mostrará un error.
Las llamadas posteriores después de la primera generarán un conjunto nuevo y único de credenciales y, además, invalidarán las credenciales generadas con anterioridad.
Una vez que la cuenta de servicio está vinculada a la empresa, se puede administrar mediante el recurso serviceAccountKeys. - getStoreLayout
- Muestra el diseño de la tienda para la empresa. Si no se estableció el diseño de la tienda, se muestra "básico" como el tipo de diseño y sin página principal.
- list
- Busca una empresa por nombre de dominio. Esto solo se admite para empresas creadas a través del flujo de creación iniciado por Google. Las empresas que se crearon con el flujo iniciado por EMM no necesitan buscar el ID, ya que este último aprende el ID de la empresa en la devolución de llamada especificada en la llamada Enterprises.generateSignupUrl.
- pullNotificationSet
- Extrae y muestra un conjunto de notificaciones para las empresas asociadas con la cuenta de servicio autenticada para la solicitud. El conjunto de notificaciones puede estar vacío si no hay ninguna notificación pendiente.
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 confirman en los 20 segundos eventualmente se volverán a incluir en la respuesta a otra solicitud PullNotificationSet y las que nunca se confirmen se borrarán en última instancia según la política del sistema de Pub/Sub de Google Cloud Platform.
Se pueden realizar varias solicitudes de forma simultánea para recuperar notificaciones, en cuyo caso las notificaciones pendientes (si las hay) se dividirán entre cada emisor, si es que hay alguna pendiente.
Si no hay notificaciones presentes, se mostrará una lista de notificaciones vacía. Las solicitudes posteriores pueden mostrar más notificaciones una vez que estén disponibles. - sendTestPushNotification
- Envía una notificación de prueba para validar la integración de EMM con el servicio de Google Cloud Pub/Sub para esta empresa.
- setAccount
- Configura la cuenta que se usará para autenticarse en la API como empresa.
- setStoreLayout
- Establece el diseño de la tienda para la empresa. De forma predeterminada, storeLayoutType se establece en "basic" y el diseño básico está habilitado. El diseño básico solo contiene apps aprobadas por el administrador que se agregaron al conjunto de productos disponible para un usuario (mediante la llamada setAvailableProductSet). Las apps de la página se ordenan según el valor de ID del producto. Si creas un diseño de tienda personalizado (estableciendo storeLayoutType = "custom" y establecer una página principal), el diseño básico de la tienda se inhabilita.
- anular la inscripción
- Anula la inscripción de una empresa en la EMM que realiza la llamada.