Importante: Ya no aceptamos registros nuevos para la API de EMM de Play. Más información

Se usó la API de Cloud Translation para traducir esta página.

Enterprises

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 y Enterprises.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 y Enterprises.completeSignup junto con la IU de registro de Google Play administrado (mecanismo proporcionado por Google) para crear la vinculación sin pasos manuales.

Como EMM, puedes admitir uno o ambos enfoques en tu consola de EMM. Consulta Crea una empresa para conocer más detalles.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}

Nombre de la propiedad	Valor	Descripción
`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.