Enterprises

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

Representaciones de recursos

Un recurso de Enterprises representa la vinculación entre una EMM y una organización específica. Se pueden crear instancias de esa vinculación de una de dos maneras diferentes usando esta API, como se indica a continuación:

  • 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 más o menos manual.
  • 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 obtener más información.

{
  "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 Esto solo es compatible con 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
Reconoce las notificaciones que se recibieron de Enterprises.PullNotificationSet para evitar que se devuelvan llamadas posteriores las mismas notificaciones.
completeSignup
Completa el flujo de registro especificando el token de finalización y Token empresarial. No se debe llamar a esta solicitud varias veces para una determinada empresa Token.
createWebToken
Muestra un token único para acceder a una IU que se puede incorporar. Para generar un IU web, pasar el token generado al código JavaScript de Google Play administrado API de gcloud. 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 el EMM que realiza la llamada.
generateSignupUrl
Genera una URL de registro.
get
Recupera el nombre y el dominio de una empresa.
getServiceAccount
Muestra una cuenta de servicio y credenciales. La cuenta de servicio pueden vincularse a una empresa llamando a setAccount. La cuenta de servicio es exclusiva de esta empresa y de EMM, y se borrará si la empresa no está delimitado. Las credenciales contienen datos de clave privada y no se almacenan del servidor.
:
Solo se puede llamar a este método después de llamar Enterprises.enroll o Enterprises.CompleteSignup, y antes Enterprises.SetAccount; otras, se mostrará un error.
:
Las llamadas subsiguientes después de la primera generarán un conjunto nuevo y único de las credenciales y, luego, invalidar las que se generaron con anterioridad.
:
Una vez que la cuenta de servicio esté vinculada a la empresa, se podrá administrar con el recurso serviceAccountKeys.
getStoreLayout
Muestra el diseño de la tienda para la empresa. Si el diseño de la tienda no se estableció, el resultado es “basic” como el tipo de diseño de tienda y no página principal.
list
Busca una empresa por nombre de dominio. Esto solo está disponible para empresas creadas a través de la red iniciada por Google de tu flujo de creación. La búsqueda del ID no es necesaria para empresas creadas a través de el flujo iniciado por EMM, ya que este aprende el ID de la empresa del de 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. La notificación establecida puede estará vacío si no hay notificaciones pendientes.
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 acepten dentro de los 20 segundos en la respuesta a otro PullNotificationSet solicitud, y las que nunca se reconocen se borrarán en última instancia según la política del sistema de Pub/Sub de Google Cloud.
Se pueden realizar varias solicitudes de forma simultánea para recuperar notificaciones, en cuyo caso las notificaciones pendientes (si las hay) se dividida entre cada emisor, si hay alguno pendiente.
Si no hay notificaciones, se muestra una lista vacía. Es posible que en las solicitudes posteriores se devuelvan más notificaciones una vez que se disponibles.
sendTestPushNotification
Envía una notificación de prueba para validar la integración de EMM con el servicio de Pub/Sub de Google Cloud para esta empresa.
setAccount
Establece la cuenta que se usará para autenticarse en la API como el .
setStoreLayout
Establece el diseño de la tienda para la empresa. De forma predeterminada, storeLayoutType está establecido en "básico" y el diseño básico de la tienda está habilitado. Aspectos básicos el diseño solo contiene apps aprobadas por el administrador y que tienen al conjunto de productos disponible para un usuario (mediante el setAvailableProductSet). Las apps de la página se ordenan según lo siguiente: su valor de ID del producto. Si creas un diseño de tienda personalizado (estableciendo storeLayoutType = "personalizado" y establecer una página de inicio), el almacén básico el diseño está inhabilitado.
dar de baja
Da de baja una empresa al EMM que realiza la llamada.