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

Para obtener una lista de los métodos de este recurso, consulta el final de esta página.

Representaciones de recursos

Un recurso de Enterprise representa la vinculación entre un EMM y una organización específica. Esa vinculación se puede crear una instancia de una de las siguientes dos maneras con esta API:

En el caso de los clientes de dominios administrados por Google, el proceso implica usar Enterprises.enroll y Enterprises.setAccount (junto con artefactos obtenidos de la Consola del administrador y la Consola de la API de Google) y enviarlos al EMM a través de un proceso más o menos manual.
En el caso de los clientes de Cuentas de Google administradas, el proceso implica usar 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 Cómo crear una empresa para obtener más información.

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

Nombre de la propiedad	Valor	Descripción
`administrator[]`	`list`	Administradores de la empresa Esto 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
`enterpriseType`	`string`	Es el tipo de empresa. Los valores aceptables son los siguientes: "`enterpriseTypeUnspecified`" "`managedGoogleDomain`" "`managedGooglePlayAccountsEnterprise`"
`id`	`string`	Es el ID único de la empresa.
`kind`	`string`
`managedGoogleDomainType`	`string`	Es el tipo de dominio de Google administrado. Los valores aceptables son los siguientes: "`managedGoogleDomainTypeUnspecified`" "`typeDomain`" "`typeTeam`"
`name`	`string`	Es 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 especificando el token de finalización y el token de Enterprise. No se debe llamar a esta solicitud varias veces para un token empresarial determinado.
createWebToken: Devuelve un token único para acceder a una IU incorporable. Para generar una IU web, pasa el token generado a la API de JavaScript de Google Play administrada. Cada token solo se puede usar para iniciar una sesión de la IU. Consulta la documentación de la API de JavaScript para obtener más información.
inscribir: Inscribe una empresa con el EMM que realiza la llamada.
generateSignupUrl: Genera una URL de registro.
get: Recupera el nombre y el dominio de una empresa.
getServiceAccount: Devuelve una cuenta de servicio y credenciales. Para vincular la cuenta de servicio a la empresa, llama a setAccount. La cuenta de servicio es única para esta empresa y el EMM, y se borrará si la empresa no está vinculada. Las credenciales contienen datos de claves privadas 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 otros casos, se mostrará un error.

Las llamadas posteriores a la primera generarán un conjunto nuevo y único de credenciales, y anularán las credenciales generadas anteriormente.

Una vez que la cuenta de servicio esté vinculada a la empresa, se puede administrar con el recurso serviceAccountKeys.
getStoreLayout: Devuelve el diseño de la tienda para la empresa. Si no se configuró el diseño de la tienda, se muestra "basic" como el tipo de diseño de la tienda y no se muestra la página principal.
list: Busca una empresa por nombre de dominio. Esto solo se admite para las empresas creadas a través del flujo de creación que inicia Google. No es necesario buscar el ID para las empresas creadas a través del flujo iniciado por el EMM, ya que el EMM obtiene el ID de la empresa en la devolución de llamada especificada en la llamada a Enterprises.generateSignupUrl.
pullNotificationSet: Extrae y muestra un conjunto de notificaciones para las empresas asociadas con la cuenta de servicio autenticada para la solicitud. Es posible que el conjunto de notificaciones esté vacío si no hay notificaciones pendientes.
Un conjunto de notificaciones que se muestra debe confirmarse en un plazo de 20 segundos mediante una llamada a Enterprises.AcknowledgeNotificationSet, a menos que el conjunto de notificaciones esté vacío.
Las notificaciones que no se confirmen en un plazo de 20 segundos se volverán a incluir en la respuesta a otra solicitud de PullNotificationSet, y las que nunca se confirmen se borrarán según la política del sistema de Pub/Sub de Google Cloud Platform.
Es posible que se realicen varias solicitudes de forma simultánea para recuperar notificaciones. En ese caso, las notificaciones pendientes (si las hay) se dividirán entre cada llamador, si las hay.
Si no hay notificaciones, se muestra una lista de notificaciones vacía. Es posible que las solicitudes posteriores muestren 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 de esta empresa.
setAccount: Establece la cuenta que se usará para autenticar en la API como la empresa.
setStoreLayout: Establece el diseño de la tienda para la empresa. De forma predeterminada, storeLayoutType se establece en "basic" y se habilita el diseño de tienda básico. El diseño básico solo contiene apps aprobadas por el administrador y que se agregaron al conjunto de productos disponibles para un usuario (con la llamada setAvailableProductSet). Las apps de la página se ordenan según el valor de su ID de producto. Si creas un diseño de tienda personalizado (estableciendo storeLayoutType = "custom" y configurando una página principal), se inhabilita el diseño básico de la tienda.
cancelar la inscripción: Da de baja una empresa del EMM que realiza la llamada.