Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
Confirma las notificaciones que se recibieron de Enterprises.PullNotificationSet para evitar que las llamadas posteriores muestren las mismas notificaciones.
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.
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.
Genera una URL de actualización empresarial para actualizar una cuenta empresarial de Google Play administrado existente a un dominio de Google administrado.
Consulta
la guía para actualizar una empresa para obtener más detalles.
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.
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.
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 EMM, ya que EMM obtiene el ID de la empresa en la devolución de llamada especificada en la llamada a Enterprises.generateSignupUrl.
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.
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 (configurando storeLayoutType = "custom" y una página principal), se inhabilita el diseño básico de la tienda.
[null,null,["Última actualización: 2025-07-28 (UTC)"],[[["\u003cp\u003eAn Enterprises resource represents the connection between an EMM and an organization, established through either manual enrollment for Google-managed domains or automated signup for managed Google Play Accounts.\u003c/p\u003e\n"],["\u003cp\u003eEMMs can support either or both enrollment methods, offering flexibility in binding with organizations.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides various methods to manage enterprises, including enrollment, sign-up, retrieval of enterprise details, and more.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eEnterprises\u003c/code\u003e resource includes properties like ID, primary domain, name, and administrators, offering comprehensive information about the enterprise.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage the API's methods to interact with and manage enterprise data, enabling seamless integration with their EMM solutions.\u003c/p\u003e\n"]]],[],null,["# Enterprises\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nAn Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows:\n\n- For Google managed domain customers, the process involves using `Enterprises.enroll` and `Enterprises.setAccount` (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process.\n- For managed Google Play Accounts customers, the process involves using `Enterprises.generateSignupUrl` and `Enterprises.completeSignup` in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps.\n\nAs an EMM, you can support either or both approaches in your EMM console. See [Create an Enterprise](/android/work/play/emm-api/create-enterprise) for details. \n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"androidenterprise#enterprise\",\n \"id\": string,\n \"primaryDomain\": string,\n \"name\": string,\n \"administrator\": [\n {\n \"email\": string\n }\n ],\n \"enterpriseType\": string,\n \"managedGoogleDomainType\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `administrator[]` | `list` | Admins of the enterprise. This is only supported for enterprises created via the EMM-initiated flow. | |\n| administrator[].`email` | `string` | The admin's email address. | |\n| `enterpriseType` | `string` | The type of the enterprise. \u003cbr /\u003e Acceptable values are: - \"`enterpriseTypeUnspecified`\" - \"`managedGoogleDomain`\" - \"`managedGooglePlayAccountsEnterprise`\" | |\n| `id` | `string` | The unique ID for the enterprise. | |\n| `kind` | `string` | | |\n| `managedGoogleDomainType` | `string` | The type of managed Google domain \u003cbr /\u003e Acceptable values are: - \"`managedGoogleDomainTypeUnspecified`\" - \"`typeDomain`\" - \"`typeTeam`\" | |\n| `name` | `string` | The name of the enterprise, for example, \"Example, Inc\". | |\n| `primaryDomain` | `string` | The enterprise's primary domain, such as \"example.com\". | |\n\nMethods\n-------\n\n[acknowledgeNotificationSet](/android/work/play/emm-api/v1/enterprises/acknowledgeNotificationSet)\n: Acknowledges notifications that were received from\n Enterprises.PullNotificationSet to prevent subsequent calls from returning\n the same notifications.\n\n[completeSignup](/android/work/play/emm-api/v1/enterprises/completeSignup)\n: Completes the signup flow, by specifying the Completion token and\n Enterprise token.\n This request must not be called multiple times for a given Enterprise\n Token.\n\n[createWebToken](/android/work/play/emm-api/v1/enterprises/createWebToken)\n: Returns a unique token to access an embeddable UI. To generate a\n web UI, pass the generated token into the managed Google Play javascript\n API. Each token may only be used to start one UI session. See the\n [JavaScript API documentation](https://developers.google.com/api-client-library/javascript/apis/androidenterprise/v1) for further information.\n\n[enroll](/android/work/play/emm-api/v1/enterprises/enroll)\n: Enrolls an enterprise with the calling EMM.\n\n[generateEnterpriseUpgradeUrl](/android/work/play/emm-api/v1/enterprises/generateEnterpriseUpgradeUrl)\n: Generates an enterprise upgrade URL to upgrade an existing managed Google\n Play Accounts enterprise to a managed Google domain.\n See [the guide to upgrading an enterprise](/android/work/play/emm-api/upgrade-an-enterprise) for more details.\n\n[generateSignupUrl](/android/work/play/emm-api/v1/enterprises/generateSignupUrl)\n: Generates a sign-up URL.\n\n[get](/android/work/play/emm-api/v1/enterprises/get)\n: Retrieves the name and domain of an enterprise.\n\n[getServiceAccount](/android/work/play/emm-api/v1/enterprises/getServiceAccount)\n: Returns a service account and credentials. The service account\n can be bound to the enterprise by calling setAccount. The service account\n is unique to this enterprise and EMM, and will be deleted if the enterprise\n is unbound. The credentials contain private key data and are not stored\n server-side.\n\n \u003cbr /\u003e\n\n\n This method can only be called after calling\n Enterprises.Enroll or Enterprises.CompleteSignup, and before\n Enterprises.SetAccount; at other times it will return an error.\n\n \u003cbr /\u003e\n\n\n Subsequent calls after the first will generate a new, unique set of\n credentials, and invalidate the previously generated credentials.\n\n \u003cbr /\u003e\n\n\n Once the service account is bound to the enterprise, it can be managed\n using the serviceAccountKeys resource.\n\n \u003cbr /\u003e\n\n\n \u003cbr /\u003e\n\n | **Note:** After you create a key, you might need to wait for 60 seconds or more before you perform another operation with the key. If you try to perform an operation with the key immediately after you create the key, and you receive an error, you can [retry\n | the request with exponential backoff](https://cloud.google.com/iam/docs/retry-strategy)\n\n \u003cbr /\u003e\n\n .\n\n[getStoreLayout](/android/work/play/emm-api/v1/enterprises/getStoreLayout)\n: Returns the store layout for the enterprise. If the store layout\n has not been set, returns \"basic\" as the store layout type and no\n homepage.\n\n[list](/android/work/play/emm-api/v1/enterprises/list)\n: Looks up an enterprise by domain name.\n This is only supported for enterprises created via the Google-initiated\n creation flow. Lookup of the id is not needed for enterprises created via\n the EMM-initiated flow since the EMM learns the enterprise ID in the\n callback specified in the Enterprises.generateSignupUrl call.\n\n[pullNotificationSet](/android/work/play/emm-api/v1/enterprises/pullNotificationSet)\n: Pulls and returns a notification set for the enterprises associated with\n the service account authenticated for the request. The notification set may\n be empty if no notification are pending.\n\n\n A notification set returned needs to be acknowledged within 20 seconds\n by calling Enterprises.AcknowledgeNotificationSet, unless the\n notification set is empty.\n\n\n Notifications that are not acknowledged within the 20 seconds will\n eventually be included again in the response to another PullNotificationSet\n request, and those that are never acknowledged will ultimately be deleted\n according to the Google Cloud Platform Pub/Sub system policy.\n\n\n Multiple requests might be performed concurrently to retrieve\n notifications, in which case the pending notifications (if any) will be\n split among each caller, if any are pending.\n\n\n If no notifications are present, an empty notification list is returned.\n Subsequent requests may return more notifications once they become\n available.\n\n[sendTestPushNotification](/android/work/play/emm-api/v1/enterprises/sendTestPushNotification)\n: Sends a test notification to validate the EMM integration with\n the Google Cloud Pub/Sub service for this enterprise.\n\n[setAccount](/android/work/play/emm-api/v1/enterprises/setAccount)\n: Sets the account that will be used to authenticate to the API as the\n enterprise.\n\n[setStoreLayout](/android/work/play/emm-api/v1/enterprises/setStoreLayout)\n: Sets the store layout for the enterprise. By default, storeLayoutType\n is set to \"basic\" and the basic store layout is enabled. The basic\n layout only contains apps approved by the admin, and that have\n been added to the available product set for a user (using the\n [setAvailableProductSet](/android/work/play/emm-api/v1/users/setAvailableProductSet) call). Apps on the page are sorted in order of\n their product ID value. If you create a custom store layout (by setting\n storeLayoutType = \"custom\" and setting a homepage), the basic store\n layout is disabled.\n\n[unenroll](/android/work/play/emm-api/v1/enterprises/unenroll)\n: Unenrolls an enterprise from the calling EMM."]]
