Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.
Ressourcendarstellungen
Eine Unternehmensressource stellt die Bindung zwischen einer EMM und einer bestimmten Organisation dar. Diese Bindung kann mit dieser API auf zwei verschiedene Arten instanziiert werden:
Für Kunden mit von Google verwalteten Domains werden Enterprises.enroll und Enterprises.setAccount in Verbindung mit Artefakten aus der Admin-Konsole und der Google API Console verwendet und mehr oder weniger manuell an die EMM-Lösung gesendet.
Kunden mit Managed Google Play-Konten verwenden Enterprises.generateSignupUrl und Enterprises.completeSignup in Verbindung mit der Anmeldeoberfläche von Managed Google Play (von Google bereitgestellter Mechanismus), um die Verknüpfung ohne manuelle Schritte zu erstellen.
Als EMM-Anbieter können Sie einen oder beide Ansätze in Ihrer EMM-Konsole unterstützen. Weitere Informationen finden Sie unter Unternehmen erstellen.
Bestätigung von Benachrichtigungen, die von „Enterprises.PullNotificationSet“ empfangen wurden, um zu verhindern, dass bei nachfolgenden Aufrufen dieselben Benachrichtigungen zurückgegeben werden.
Führt die Registrierung durch, indem das Abschlusstoken und das Enterprise-Token angegeben werden.
Diese Anfrage darf nicht mehrmals für ein bestimmtes Unternehmenstoken aufgerufen werden.
Gibt ein eindeutiges Token für den Zugriff auf eine einbettbare Benutzeroberfläche zurück. Wenn Sie eine Web-UI generieren möchten, geben Sie das generierte Token an die JavaScript API für den Managed Google Play Store weiter. Jedes Token kann nur zum Starten einer UI-Sitzung verwendet werden. Weitere Informationen finden Sie in der
JavaScript API-Dokumentation.
Erzeugt eine URL für das Upgrade eines Unternehmens, um eine vorhandene Kontogruppe für Managed Google Play auf eine verwaltete Google-Domain umzustellen.
Weitere Informationen finden Sie im
Leitfaden zum Upgrade eines Unternehmens.
Gibt ein Dienstkonto und Anmeldedaten zurück. Das Dienstkonto kann durch Aufrufen von setAccount an das Unternehmen gebunden werden. Das Dienstkonto ist für dieses Unternehmen und diese EMM eindeutig und wird gelöscht, wenn die Bindung des Unternehmens aufgehoben wird. Die Anmeldedaten enthalten Daten für den privaten Schlüssel und werden nicht serverseitig gespeichert.
Diese Methode kann nur nach dem Aufruf von „Enterprises.Enroll“ oder „Enterprises.CompleteSignup“ und vor „Enterprises.SetAccount“ aufgerufen werden. Andernfalls wird ein Fehler zurückgegeben.
Bei nachfolgenden Aufrufen nach dem ersten werden neue, eindeutige Anmeldedaten generiert und die zuvor generierten Anmeldedaten ungültig.
Nachdem das Dienstkonto an das Unternehmen gebunden ist, kann es über die Ressource „serviceAccountKeys“ verwaltet werden.
Gibt das Ladenlayout für das Unternehmen zurück. Wenn das Geschäftslayout nicht festgelegt wurde, wird „einfach“ als Geschäftslayouttyp und keine Startseite zurückgegeben.
Sucht ein Unternehmen nach Domainnamen ab.
Dies wird nur für Unternehmen unterstützt, die über den von Google initiierten Erstellungsvorgang erstellt wurden. Für Unternehmen, die über den vom EMM initiierten Ablauf erstellt wurden, ist keine Suche nach der ID erforderlich, da der EMM die Unternehmens-ID im Rückruf erhält, der im Aufruf von „Enterprises.generateSignupUrl“ angegeben ist.
Liest und gibt einen Benachrichtigungssatz für die Unternehmen zurück, die mit dem Dienstkonto verknüpft sind, das für die Anfrage authentifiziert wurde. Die Benachrichtigungsgruppe ist möglicherweise leer, wenn keine Benachrichtigungen ausstehen.
Eine zurückgegebene Benachrichtigungsgruppe muss innerhalb von 20 Sekunden durch Aufrufen von „Enterprises.AcknowledgeNotificationSet“ bestätigt werden, es sei denn, die Benachrichtigungsgruppe ist leer.
Benachrichtigungen, die nicht innerhalb von 20 Sekunden bestätigt werden, werden in der Antwort auf eine weitere PullNotificationSet-Anfrage wieder aufgenommen. Benachrichtigungen, die nie bestätigt werden, werden gemäß der Google Cloud Platform Pub/Sub-Systemrichtlinie gelöscht.
Es können mehrere Anfragen gleichzeitig ausgeführt werden, um Benachrichtigungen abzurufen. In diesem Fall werden ausstehende Benachrichtigungen (falls vorhanden) auf die einzelnen Aufrufer aufgeteilt.
Wenn keine Benachrichtigungen vorhanden sind, wird eine leere Benachrichtigungsliste zurückgegeben.
Bei nachfolgenden Anfragen werden möglicherweise weitere Benachrichtigungen zurückgegeben, sobald sie verfügbar sind.
Legt das Store-Layout für das Unternehmen fest. Standardmäßig ist „storeLayoutType“ auf „basic“ festgelegt und das einfache Store-Layout ist aktiviert. Das einfache Layout enthält nur Apps, die vom Administrator genehmigt und dem verfügbaren Produktsatz für einen Nutzer hinzugefügt wurden (mit dem Aufruf
setAvailableProductSet). Die Apps auf der Seite werden nach dem Wert der Produkt-ID sortiert. Wenn Sie ein benutzerdefiniertes Store-Layout erstellen (indem Sie „storeLayoutType“ auf „custom“ festlegen und eine Startseite festlegen), wird das grundlegende Store-Layout deaktiviert.
[null,null,["Zuletzt aktualisiert: 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."]]
