Crea una empresa

Un recurso Enterprise vincula una organización con tu solución de administración de Android. Devices y Policies pertenecen a una empresa. Por lo general, un solo recurso empresarial está asociado con una sola organización. Sin embargo, puedes crear varias empresas para la misma organización según sus necesidades. Por ejemplo, una organización puede querer empresas independientes para sus diferentes departamentos o regiones.

Los pasos básicos para crear una empresa se describen en la Guía de inicio rápido. En esta página, se describe el proceso con más detalle. Hay dos formas de crear una empresa:

  • Empresa administrada por el cliente: Esta es la forma recomendada de crear una empresa. No configures el parámetro de consulta agreementAccepted ni el campo contactInfo cuando llames al método “enterprises.create”.
  • Empresa administrada por EMM: este no es el método preferido para crear una empresa, pero sí es posible crear y administrar una empresa administrada por EMM con este método. Configura el parámetro de consulta agreementAccepted y el campo contactInfo cuando llames al método “enterprises.create”.

Empresas administradas por el cliente

Este es el método preferido para crear una empresa y se explica con más detalle de la siguiente manera:

1. Recupera la URL de registro

Llama a signupUrls.create para recuperar la URL de registro y especificar los siguientes dos parámetros:

  • callbackUrl: Es una URL HTTPS a la que el asistente de configuración redirecciona después de que se completa el registro empresarial. Por lo general, es tu consola de administración.
  • projectId: ID del proyecto

La respuesta contiene un url y una name. Abre el url y anota el name.

2. El administrador de TI empresarial completa el flujo de registro

El url guía al administrador empresarial a través del proceso de registro empresarial. Necesitan una cuenta de Gmail que no esté asociada a una empresa. Después de registrar correctamente su empresa, el flujo de registro redirecciona a tu callbackUrl. Se agrega un enterpriseToken a callbackUrl.

Ejemplo

https://example.com/?enterpriseToken=EAH2pBTtGCs2K28dqhq5uw0uCyVzYMqGivap4wdlH7KNlPtCmlC8uyl

3. Crea una empresa

Para crear una empresa, llama a enterprises.create. Además de crear un ID empresarial único, este método te permite definir ciertas opciones de configuración específicas de la empresa. Por ejemplo, puedes configurar el color predominante que se muestra durante el aprovisionamiento del dispositivo (primaryColor), junto con el nombre o título (enterpriseDisplayName) y el logotipo (logo) que se muestran a los usuarios finales.

Ejemplo

En los siguientes ejemplos, se usa la biblioteca cliente de Java para crear una empresa y mostrar su nombre. Consulta la página de muestra para obtener más información sobre el uso de la biblioteca.

private String createEnterprise(AndroidManagement androidManagementClient)
    throws IOException {
  SignupUrl signupUrl =
      androidManagementClient
          .signupUrls()
          .create()
          .setProjectId("myProject")
          .setCallbackUrl("https://example.com/myEmmConsole")
          .execute();

  String enterpriseToken = displayUrlToAdmin(signupUrl.getUrl());

  Enterprise enterprise =
      androidManagementClient
          .enterprises()
          .create(new Enterprise())
          .setProjectId("myProject")
          .setSignupUrlName(signupUrl.getName())
          .setEnterpriseToken(enterpriseToken)
          .execute();

  return enterprise.getName();
}

/**
 * Displays the signup URL to the admin and returns the enterprise token which
 * is generated after the admin goes through the signup flow. This functionality
 * must be implemented by your management console.
 */
private String displayUrlToAdmin(String url) {
  ...
}

Empresas administradas por EMM

Esta ya no es la forma recomendada para crear una empresa. Con este método, los EMM tienen control sobre todo el ciclo de vida de una empresa. Asegúrate de revisar las Condiciones del Servicio, que incluyen información como qué información recopilar y tus obligaciones con los clientes en relación con esta función para garantizar que tu solución cumpla con todos los requisitos de la API. Algunos de esos detalles se destacan a continuación:

1. Requisitos previos

  1. Recopila la dirección de correo electrónico del administrador empresarial.
  2. Permite que tu cliente te proporcione la información de contacto de su oficial de protección de datos y su representante de la Unión Europea. También debes permitir que el cliente modifique la información de contacto y, si lo hace, que comunique la nueva información de contacto a Google (con enterprises.patch).
  3. Muéstrale al administrador empresarial el Acuerdo de Google Play administrado y registra la identidad del cliente y del usuario, así como la fecha y hora de aceptación en tu propio sistema.

2. Crea la empresa

Para crear una empresa, llama a enterprises.create y pasa los siguientes valores:

  • Configura agreementAccepted como true, según la finalización del paso 3 en los requisitos previos.
  • Configura contactInfo en el recurso Enterprise con los detalles de contacto que recopilaste del administrador empresarial en los pasos 1 y 2. Ten en cuenta que el objeto contactEmail es obligatorio. Esto puede incluir lo siguiente: 
    {
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
  • Además de crear un ID de empresa único, este método te permite definir ciertas opciones de configuración específicas de la empresa. Por ejemplo, puedes configurar el color predominante que se mostrará en la IU de la app de administración de dispositivos (primaryColor), junto con el nombre o título (enterpriseDisplayName) y el logotipo (logo) que se mostrarán a los usuarios finales.

Eres responsable del ciclo de vida de la empresa (crear, actualizar y borrar). Ahora puedes actualizarla usando enterprises.patch y borrarla con enterprises.delete. Debes borrar la empresa cuando tu cliente finalice su relación contigo.

3. Actualiza y enumera tus empresas

Para cambiar el contactInfo de una empresa, llama a enterprises.patch y establece contactInfo en el recurso Enterprise. Ten en cuenta lo siguiente:

  • Si update_mask incluye contactInfo y pasas un valor contactInfo vacío, la llamada fallará.
  • Si no se configura update_mask y se omite contactInfo, no se realizará ningún cambio a contactInfo.

Para recuperar una lista de todas tus empresas administradas por EMM, llama a enterprises.list. La respuesta solo contiene estos campos para cada empresa:

  • name: Es el nombre de la empresa con el formato enterprises/{enterpriseId}.
  • enterpriseDisplayName: Es el nombre de la empresa que se muestra a los usuarios.

Para recuperar los otros campos, llama a enterprises.get con el name de una empresa específica.

Ejemplo

En los siguientes ejemplos, se usa la biblioteca cliente de Java para crear una empresa y mostrar su nombre. Consulta la página de muestra para obtener más información sobre el uso de la biblioteca.

Sigue estos pasos para crear una empresa:

private String createEnterprise(AndroidManagement androidManagementClient)
    throws IOException {
  ContactInfo contactInfo = new ContactInfo();
  contactInfo.setContactEmail("contact@example.com");
  contactInfo.setDataProtectionOfficerName("John Doe");
  contactInfo.setDataProtectionOfficerEmail("dpo@example.com");
  contactInfo.setDataProtectionOfficerPhone("+33 1 99 00 98 76 54");
  contactInfo.setEuRepresentativeName("Jane Doe");
  contactInfo.setEuRepresentativeEmail("eurep@example.com");
  contactInfo.setEuRepresentativePhone("+33 1 99 00 12 34 56");

  Enterprise enterprise = new Enterprise();
  enterprise.setEnterpriseDisplayName("Example Enterprise");

  Enterprise enterprise =
      androidManagementClient
          .enterprises()
          .create(enterprise)
          .setProjectId("myProject")
          .setContactInfo(contactInfo)
          .setAgreementAccepted(true)
          .execute();

  return enterprise.getName();
}

Para borrar una empresa, haz lo siguiente:

private void deleteEnterprise(AndroidManagement androidManagementClient, String enterpriseName)
    throws IOException {
  Enterprise enterprise = new Enterprise();
  // The enterprise name is in the form of enterprises/{enterpriseId}
  enterprise.setName(enterpriseName);

  Enterprise enterprise =
      androidManagementClient
          .enterprises()
          .delete(enterprise)
          .execute();
}