Enterprises

Si quieres obtener una lista de métodos para este recurso, consulta el final de esta página.

Representaciones de recursos

Un recurso empresarial representa la vinculación entre un EMM y una organización específica. Se pueden crear instancias de esa vinculación 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 los artefactos obtenidos de la Consola del administrador y la Consola de API de Google) y se envían a EMM a través de un proceso manual más o menos.
  • Para los clientes de cuentas de Google Play administrado, 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, puede admitir uno de los enfoques, o ambos, en su consola de EMM. Consulta Crea una empresa para obtener más detalles.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}
Nombre de la propiedad Valor Descripción Notas
administrator[] list Los administradores de la empresa. Solo se admite para las 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, "Ejemplo, Inc".
primaryDomain string El dominio principal de la empresa, como "example.com".

Métodos

acknowledgeNotificationSet
Confirma las notificaciones que se recibieron de Enterprises.PullNotificationSet para evitar que las llamadas posteriores muestren las mismas notificaciones.
completeSignup
Completa el flujo de registro mediante la especificación del token de finalización y del 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 administrada de Google Play. Cada token solo se puede utilizar 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 en el EMM que realiza la llamada.
generateSignupUrl
Genera una URL de registro.
obtener
Recupera el nombre y el dominio de una empresa.
getServiceAccount
Muestra una cuenta de servicio y credenciales. La cuenta de servicio se puede vincular a la empresa llamando a setAccount. La cuenta de servicio es exclusiva de esta empresa y de EMM, y se borrará si la empresa no está vinculada. Las credenciales contienen datos de clave privada y no se almacenan del lado del servidor.

Este método solo se puede llamar 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 nuevo conjunto de credenciales único 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 con el recurso serviceAccountKeys.
getStoreLayout.
Muestra el diseño de tienda para la empresa. Si no se estableció el diseño de la tienda, se muestra el valor "basic" como el tipo de diseño de la tienda y no como la página principal.
list
Busca una empresa por el nombre del dominio. Esto solo es compatible con las empresas creadas a través del flujo de creación iniciado por Google. La búsqueda del ID no es necesaria para las empresas creadas a través del flujo iniciado por EMM, ya que este 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 en la solicitud. El conjunto de notificaciones puede estar vacío si no hay una notificación pendiente.
Un conjunto de notificaciones que se muestra debe confirmar su recepción en 20 segundos llamando a Enterprises.AcknowledgeNotificationSet, a menos que esté vacío.
Las notificaciones que no se confirmen dentro de los 20 segundos se incluirán de nuevo en la respuesta a otra solicitud PullNotificationSet, y las que nunca se reconozcan se borrarán de acuerdo con la política del sistema de Google Cloud Platform Pub/Sub.
Es posible que se realicen 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, se muestra una lista vacía. Las solicitudes posteriores pueden mostrar más notificaciones cuando están disponibles.
sendTestPushNotification.
Envía una notificación de prueba a fin de 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 configura como "basic" y el diseño básico de la tienda está habilitado. El diseño básico solo contiene apps aprobadas por el administrador y 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 del ID del producto. Si creas un diseño personalizado de Store (configurando storeLayoutType = "custom" y configurando una página principal), el diseño básico de tienda se inhabilita.
anular la inscripción
Cancela la inscripción de una empresa en EMM que realiza la llamada.