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 Enterprises representa la vinculación entre un EMM y una organización específica. Esta vinculación se puede crear de dos maneras diferentes con esta API, como se indica a continuación:

• En el caso de 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 APIs de Google) y se envía al EMM a través de un proceso más o menos manual.
• En el caso de los clientes con Cuentas de Google Play administrado, 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 Crea una empresa para obtener más información.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nombre de la propiedad	Valor	Descripción	Notas
administrator[]	list	Administradores de la empresa Esto solo se admite para las empresas creadas a través del flujo iniciado por el EMM.
administrator[].email	string	Es 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"
googleAuthenticationSettings	nested object	Es la configuración para la autenticación de usuarios proporcionada por Google.
googleAuthenticationSettings.createdAt	nested object	Es la marca de tiempo de la primera vez que se creó o modificó la configuración.
googleAuthenticationSettings.createdAt.nanos	integer	Fracciones no negativas de un segundo a una resolución de nanosegundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser de 0 a 999,999,999 inclusive.
googleAuthenticationSettings.createdAt.seconds	long	Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe ser de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z inclusive.
googleAuthenticationSettings.dedicatedDevicesAllowed	string	Indica si se permiten los dispositivos de uso específico. Los valores aceptables son los siguientes: "allowed" "dedicatedDevicesAllowedUnspecified" "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired	string	Indica si se requiere la autenticación de Google. Los valores aceptables son los siguientes: "googleAuthenticationRequiredUnspecified" "notRequired" "required"
googleAuthenticationSettings.updatedAt	nested object	Es la marca de tiempo de la última modificación de la configuración.
googleAuthenticationSettings.updatedAt.nanos	integer	Fracciones no negativas de un segundo a una resolución de nanosegundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser de 0 a 999,999,999 inclusive.
googleAuthenticationSettings.updatedAt.seconds	long	Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe ser de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z inclusive.
id	string	Es el ID único de la empresa.
id	string	Es el ID único de la empresa.
kind	string
managedGoogleDomainType	string	Tipo de dominio administrado de Google Los valores aceptables son los siguientes: "managedGoogleDomainTypeUnspecified" "typeDomain" "typeTeam"
name	string	Es el nombre de la empresa, por ejemplo, "Ejemplo, Inc.".
primaryDomain	string	Es el dominio principal de la empresa, como "example.com".

Métodos

acknowledgeNotificationSet

Confirma las notificaciones que se recibieron de las empresas.Establece PullNotificationSet para evitar que las llamadas posteriores devuelvan las mismas notificaciones.

completeSignup

Completa el flujo de registro especificando el token de finalización y el token de la empresa. 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 administrado. Cada token solo se puede usar para iniciar una sesión de IU. Para obtener más información, consulta la documentación de la API de JavaScript.

enroll

Inscribe una empresa en el EMM de llamadas.

generateEnterpriseUpgradeUrl

Genera una URL de actualización de la empresa para actualizar una empresa existente de cuentas de Google Play administrado a un dominio de Google administrado. Consulta la guía para actualizar una empresa para obtener más detalles.

generateSignupUrl

Genera una URL de registro.

get

Recupera el nombre y el dominio de una empresa.

getServiceAccount

Devuelve 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 EMM, y se borrará si se desvincula la empresa. 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 momentos, mostrará un error.

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

Una vez que la cuenta de servicio esté vinculada a la empresa, se podrá administrar con el recurso serviceAccountKeys.

Nota: Después de crear una clave, es posible que debas esperar 60 segundos o más antes de realizar otra operación con la clave. Si intentas realizar una operación con la clave inmediatamente después de crearla y recibes un error, puedes reintentar la solicitud con una retirada exponencial.

.

getStoreLayout

Devuelve el diseño de la tienda para la empresa. Si no se estableció 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 iniciado por Google. No es necesario buscar el ID de las empresas creadas a través del flujo iniciado por el EMM, ya que el EMM conoce el ID de la empresa en la devolución de llamada especificada en la llamada a Enterprises.generateSignupUrl.

pullNotificationSet

Recupera y devuelve un conjunto de notificaciones para las empresas asociadas con la cuenta de servicio autenticada para la solicitud. El conjunto de notificaciones puede estar vacío si no hay notificaciones pendientes.
Se debe confirmar la recepción de un conjunto de notificaciones 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 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 Google Cloud 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 llamador, si hay alguna pendiente.
Si no hay notificaciones, se devuelve una lista de notificaciones vacía. Las solicitudes posteriores pueden devolver más notificaciones una vez que estén disponibles.

sendTestPushNotification

Envía una notificación de prueba para validar la integración del EMM con el servicio de Google Cloud Pub/Sub para esta empresa.

setAccount

Establece la cuenta que se usará para autenticarse en la API como la empresa.

setStoreLayout

Establece el diseño de la tienda para la empresa. De forma predeterminada, storeLayoutType se establece en "básico" y se habilita el diseño básico de la tienda. El diseño básico solo contiene las 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 (configurando storeLayoutType = "custom" y estableciendo una página principal), se inhabilitará el diseño de tienda básico.

anular la inscripción

Da de baja la inscripción de una empresa en el EMM de llamadas.