Importante:non accettiamo più nuove registrazioni per l'API Play EMM.
Scopri di più.
Enterprises
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.
Rappresentazioni delle risorse
Una risorsa Enterprises rappresenta il legame tra un EMM e un'organizzazione specifica. Questa associazione può essere creata in due modi diversi utilizzando questa API come segue:
- Per i clienti con domini gestiti da Google, la procedura prevede l'utilizzo di
Enterprises.enroll e Enterprises.setAccount (in combinazione con gli elementi ottenuti dalla Console di amministrazione e dalla Console API Google) e l'invio all'EMM tramite una procedura più o meno manuale. - Per i clienti con account della versione gestita di Google Play, la procedura prevede l'utilizzo di
Enterprises.generateSignupUrl e Enterprises.completeSignup in combinazione con l'interfaccia utente di registrazione della versione gestita di Google Play (meccanismo fornito da Google) per creare il collegamento senza passaggi manuali.
In qualità di fornitore EMM, puoi supportare uno o entrambi gli approcci nella tua console EMM. Per informazioni dettagliate, vedi Creare un'organizzazione.
{
"kind": "androidenterprise#enterprise",
"id": string,
"primaryDomain": string,
"name": string,
"administrator": [
{
"email": string
}
],
"enterpriseType": string,
"managedGoogleDomainType": string
}
| Nome proprietà |
Valore |
Descrizione |
Note |
administrator[] |
list |
Amministratori dell'azienda. Questa opzione è supportata solo per le aziende create tramite il flusso avviato dall'EMM.
|
|
administrator[].email |
string |
L'indirizzo email dell'amministratore. |
|
enterpriseType |
string |
Il tipo di azienda.
I valori accettati sono:
- "
enterpriseTypeUnspecified"
- "
managedGoogleDomain"
- "
managedGooglePlayAccountsEnterprise"
|
|
id |
string |
L'ID univoco dell'azienda.
|
|
kind |
string |
|
|
managedGoogleDomainType |
string |
Il tipo di dominio Google gestito
I valori accettati sono:
- "
managedGoogleDomainTypeUnspecified"
- "
typeDomain"
- "
typeTeam"
|
|
name |
string |
Il nome dell'azienda, ad esempio "Example, Inc". |
|
primaryDomain |
string |
Il dominio principale dell'azienda, ad esempio "example.com". |
|
Metodi
- acknowledgeNotificationSet
- Acconsente alle notifiche ricevute da
Enterprises.PullNotificationSet per impedire alle chiamate successive di restituire
le stesse notifiche.
- completeSignup
- Completa la procedura di registrazione specificando il token di completamento e il token dell'azienda.
Questa richiesta non deve essere chiamata più volte per un determinato token Enterprise.
- createWebToken
- Restituisce un token univoco per accedere a un'interfaccia utente incorporabile. Per generare un'UI web, passa il token generato all'API JavaScript della versione gestita di Google Play. Ogni token può essere utilizzato solo per avviare una sessione dell'interfaccia utente. Per ulteriori informazioni, consulta la
documentazione dell'API JavaScript.
- registrarsi
- Registra un'azienda con il provider EMM che effettua la chiamata.
- generateEnterpriseUpgradeUrl
- Genera un URL di upgrade aziendale per eseguire l'upgrade di account Google Play gestiti per l'azienda esistenti a un dominio Google gestito.
Per ulteriori dettagli, consulta la
guida all'upgrade di un'azienda.
- generateSignupUrl
- Genera un URL di registrazione.
- get
- Recupero del nome e del dominio di un'azienda.
- getServiceAccount
- Restituisce un account di servizio e le relative credenziali. L'account di servizio
puoi essere associato all'azienda chiamando setAccount. L'account di servizio è univoco per questa azienda e per questo EMM e verrà eliminato se l'azienda non è associata. Le credenziali contengono dati della chiave privata e non vengono memorizzate sul lato server.
Questo metodo può essere chiamato solo dopo aver chiamato
Enterprises.Enroll o Enterprises.CompleteSignup e prima di
Enterprises.SetAccount; in altri casi restituirà un errore.
Le chiamate successive alla prima genereranno un nuovo insieme univoco di credenziali e invalideranno quelle generate in precedenza.
Una volta associato all'azienda, l'account di servizio può essere gestito
utilizzando la risorsa serviceAccountKeys.
..
- getStoreLayout
- Restituisce il layout del negozio per l'azienda. Se il layout del negozio
non è stato impostato, viene restituito "base" come tipo di layout del negozio e non viene visualizzata alcuna
home page.
- list
- Cerca un'azienda tramite il nome di dominio.
Questa opzione è supportata solo per le aziende create tramite il flusso di creazione avviato da Google. La ricerca dell'ID non è necessaria per le aziende create tramite il flusso avviato dall'EMM, poiché l'EMM acquisisce l'ID azienda nel callback specificato nella chiamata Enterprises.generateSignupUrl.
- pullNotificationSet
- Estrae e restituisce un insieme di notifiche per le aziende associate all'account di servizio autenticato per la richiesta. L'insieme di notifiche può essere vuoto se non ci sono notifiche in attesa.
Un insieme di notifiche restituito deve essere confermato entro 20 secondi
chiamando Enterprises.AcknowledgeNotificationSet, a meno che il
insieme di notifiche non sia vuoto.
Le notifiche che non vengono confermate entro 20 secondi verranno nuovamente incluse nella risposta a un'altra richiesta PullNotificationSet e quelle che non vengono mai confermate verranno infine eliminate in base alle norme del sistema Pub/Sub della piattaforma Google Cloud.
Per recuperare le notifiche potrebbero essere eseguite più richieste contemporaneamente, nel qual caso le notifiche in attesa (se presenti) verranno suddivise tra ciascun chiamante.
Se non sono presenti notifiche, viene restituito un elenco di notifiche vuoto.
Le richieste successive potrebbero restituire altre notifiche non appena diventano disponibili.
- sendTestPushNotification
- Invia una notifica di prova per convalidare l'integrazione di EMM con il servizio Google Cloud Pub/Sub per l'azienda.
- setAccount
- Imposta l'account che verrà utilizzato per l'autenticazione all'API come azienda.
- setStoreLayout
- Imposta il layout del negozio per l'azienda. Per impostazione predefinita, storeLayoutType è impostato su "base" e il layout della vetrina di base è attivo. Il layout di base contiene solo le app approvate dall'amministratore e aggiunte all'insieme di prodotti disponibili per un utente (utilizzando la chiamata
setAvailableProductSet). Le app nella pagina sono ordinate in base al valore del loro ID prodotto. Se crei un layout della vetrina personalizzato (impostando
storeLayoutType = "custom" e impostando una home page), il layout della vetrina
di base viene disattivato.
- annullare la registrazione
- Annullare la registrazione di un'azienda dal provider EMM che effettua la chiamata.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-28 UTC.
[null,null,["Ultimo aggiornamento 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."]]
