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