Questo riferimento API è organizzato per tipo di risorsa. Ogni tipo di risorsa ha una o più rappresentazioni dei dati e uno o più metodi.
Tipi di risorse
- Dispositivi
- Aziende
- Diritti
- Licenze di gruppo
- Utenti licenze di gruppo
- Installazioni
- Configurazioni gestite per il dispositivo
- Configurazioni gestiteper l'utente
- Impostazioni gestite della configurazione
- Autorizzazioni
- Prodotti
- Chiavi account di servizio
- Storelayoutcluster
- Storelayoutpages
- Utenti
- App web
Dispositivi
Per i dettagli delle risorse dispositivi, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
forceReportUpload |
POST /enterprises/enterpriseId/users/userId/devices/deviceId/forceReportUpload
|
Carica un report contenente eventuali modifiche agli stati dell'app sul dispositivo dalla generazione dell'ultimo report. Puoi chiamare questo metodo fino a 3 volte ogni 24 ore per un determinato dispositivo. |
trova |
GET /enterprises/enterpriseId/users/userId/devices/deviceId
|
Recupera i dettagli di un dispositivo. |
getState |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/state
|
Recupera se l'accesso di un dispositivo ai servizi Google è attivato o disattivato. Lo stato del dispositivo ha effetto solo se l'applicazione dei criteri EMM sui dispositivi Android è abilitata nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e a tutti i dispositivi viene consentito l'accesso ai servizi Google. Questo attributo è supportato solo per gli utenti gestiti da Google. |
list |
GET /enterprises/enterpriseId/users/userId/devices
|
Recupera gli ID di tutti i dispositivi di un utente. |
setState |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/state
|
Consente di impostare l'attivazione o la disattivazione dell'accesso di un dispositivo ai servizi Google. Lo stato del dispositivo ha effetto solo se l'applicazione dei criteri EMM sui dispositivi Android è abilitata nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e a tutti i dispositivi viene consentito l'accesso ai servizi Google. Questo attributo è supportato solo per gli utenti gestiti da Google. |
aggiorna |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId
|
Consente di aggiornare i criteri relativi ai dispositivi.
Per garantire che il criterio venga applicato correttamente, devi impedire agli account non gestiti di accedere a Google Play impostando allowed_accounts nella configurazione gestita per il pacchetto Google Play. Consulta l'articolo Limitare gli account in Google Play.
|
Aziende
Per i dettagli sulle risorse aziendali, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
acknowledgeNotificationSet |
POST /enterprises/acknowledgeNotificationSet
|
Conferma le notifiche ricevute da Enterprises.PullNotificationSet per impedire che chiamate successive restituiscano le stesse notifiche. |
completeSignup |
POST /enterprises/completeSignup
|
Completa il flusso di registrazione specificando il token di completamento e il token aziendale. Questa richiesta non deve essere richiamata più volte per un determinato token Enterprise. |
createWebToken |
POST /enterprises/enterpriseId/createWebToken
|
Restituisce un token univoco per accedere a un'interfaccia utente incorporabile. Per generare un'interfaccia utente 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. |
registra |
POST /enterprises/enroll
|
Registra un'azienda con l'EMM che gestisce le chiamate.
Parametri di query obbligatori:
|
generateSignupUrl |
POST /enterprises/signupUrl
|
Genera un URL di registrazione. |
trova |
GET /enterprises/enterpriseId
|
Recupera il nome e il dominio di un'azienda. |
getServiceAccount |
GET /enterprises/enterpriseId/serviceAccount
|
Restituisce un account di servizio e le credenziali. L'account di servizio può essere associato
all'azienda chiamando setAccount. L'account di servizio è univoco per questa azienda e per l'EMM e verrà eliminato se l'azienda non è associata. Le credenziali contengono dati di chiavi private e non sono archiviate lato server.
Questo metodo può essere chiamato solo dopo la chiamata Enterprises.Enrollment o Enterprises.CompleteSignup e prima Enterprises.SetAccount; in altri casi verrà restituito un errore. Le chiamate successive dopo la prima generano un nuovo insieme univoco di credenziali e invalidano le credenziali generate in precedenza. Una volta associato l'account di servizio all'azienda, può essere gestito utilizzando la risorsa serviceAccountKeys. |
getStoreLayout |
GET /enterprises/enterpriseId/storeLayout
|
Restituisce il layout del negozio per l'azienda. Se il layout del negozio non è stato impostato, restituisce "basic" come tipo di layout e nessuna home page. |
list |
GET /enterprises
|
Cerca un'azienda per 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 tramite EMM, poiché l'EMM rileva l'ID azienda nel callback specificato nella chiamata Enterprises.generateSignupUrl.
Parametri di query obbligatori:
|
pullNotificationSet |
POST /enterprises/pullNotificationSet
|
Esegue il pull e restituisce un set di notifiche per le aziende associate all'account di servizio autenticato per la richiesta. Il set di notifiche potrebbe
essere vuoto se non ci sono notifiche in attesa.
Un set di notifiche restituito deve essere confermato entro 20 secondi chiamando Enterprises.AcknowledgeNotificationSet, a meno che il set di notifiche non sia vuoto. Le notifiche che non vengono riconosciute entro 20 secondi verranno in seguito incluse di nuovo nella risposta a un'altra richiesta PullNotificationSet e quelle che non vengono mai riconosciute verranno eliminate in base al criterio del sistema Pub/Sub della piattaforma Google Cloud. Potrebbero essere eseguite contemporaneamente più richieste per recuperare le notifiche, nel qual caso le notifiche in sospeso (se presenti) verranno suddivise tra ciascun chiamante, se in sospeso. Se non sono presenti notifiche, viene restituito un elenco di notifiche vuoto. Le richieste successive potrebbero restituire altre notifiche non appena diventano disponibili. |
sendTestPushNotification |
POST /enterprises/enterpriseId/sendTestPushNotification
|
Invia una notifica di prova per convalidare l'integrazione EMM con il servizio Google Cloud Pub/Sub per questa azienda. |
setAccount |
PUT /enterprises/enterpriseId/account
|
Imposta l'account che verrà utilizzato per eseguire l'autenticazione nell'API come azienda. |
setStoreLayout |
PUT /enterprises/enterpriseId/storeLayout
|
Imposta il layout del negozio per l'azienda. Per impostazione predefinita, storeLayoutType è impostato su "basic" e il layout di base del negozio è attivato. Il layout di base contiene solo le app approvate dall'amministratore che sono state aggiunte al set di prodotti disponibile per un utente (utilizzando la chiamata setAvailableProductSet). Le app nella pagina sono ordinate in base al valore dell'ID prodotto. Se crei un layout del negozio personalizzato (impostando storeLayoutType = "custom" e una home page), il layout di base del negozio viene disattivato. |
annullare l'iscrizione |
POST /enterprises/enterpriseId/unenroll
|
Annulla la registrazione di un'azienda all'EMM che chiama. |
Entitlement
Per i dettagli delle risorse dei diritti, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
Rimuove il diritto di un utente relativamente a un'app. |
trova |
GET /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
Recupera i dettagli di un diritto. |
list |
GET /enterprises/enterpriseId/users/userId/entitlements
|
Elenca tutti i diritti per l'utente specificato. Viene impostato solo l'ID. |
aggiorna |
PUT /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
Aggiunge o aggiorna un diritto relativo a un'app per un utente. |
Licenze di gruppo
Per i dettagli delle risorse Grouplicenses, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
trova |
GET /enterprises/enterpriseId/groupLicenses/groupLicenseId
|
Recupera i dettagli di una licenza di gruppo aziendale per un prodotto. |
list |
GET /enterprises/enterpriseId/groupLicenses
|
Recupera gli ID di tutti i prodotti per i quali l'azienda ha una licenza di gruppo. |
Utenti licenze di gruppo
Per i dettagli delle risorse Grouplicenseusers, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
list |
GET /enterprises/enterpriseId/groupLicenses/groupLicenseId/users
|
Recupera gli ID degli utenti a cui sono stati concessi i diritti in base alla licenza. |
Installazioni
Per i dettagli delle risorse di installazione, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
Richieste di rimozione di un'app da un dispositivo. Una chiamata al numero get o
list continuerà a mostrare l'app come installata sul dispositivo finché
non viene effettivamente rimossa.
|
trova |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
Recupera i dettagli di un'installazione di un'app su un dispositivo. |
list |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/installs
|
Recupera i dettagli di tutte le app installate sul dispositivo specificato. |
aggiorna |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
Richiede l'installazione della versione più recente di un'app su un dispositivo. Se l'app è già installata, viene aggiornata all'ultima versione, se necessario. |
Configurazioni gestiteper il dispositivo
Per i dettagli delle risorse per le configurazioni gestite, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
Rimuove una configurazione gestita per dispositivo di un'app per il dispositivo specificato. |
trova |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
Recupera i dettagli di una configurazione gestita per dispositivo. |
list |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice
|
Elenca tutte le configurazioni gestite per dispositivo del dispositivo specificato. Viene impostato solo l'ID. |
aggiorna |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
Aggiunge o aggiorna una configurazione gestita per dispositivo per un'app per il dispositivo specificato. |
Configurazioni gestiteper l'utente
Per i dettagli sulle risorse per le configurazioni gestite dell'utente, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
Rimuove una configurazione gestita per utente di un'app per l'utente specificato. |
trova |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
Recupera i dettagli di una configurazione gestita per utente per un'app per l'utente specificato. |
list |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser
|
Elenca tutte le configurazioni gestite per utente per l'utente specificato. Viene impostato solo l'ID. |
aggiorna |
PUT /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
Aggiunge o aggiorna le impostazioni di configurazione gestita di un'app per l'utente specificato.
Se supporti l'iframe delle configurazioni gestite,
puoi applicare le configurazioni gestite a un utente specificando nella richiesta un mcmId
e le eventuali variabili di configurazione associate. In alternativa, tutti i provider EMM possono applicare configurazioni gestite trasmettendo un elenco di proprietà gestite.
|
Impostazioni delle configurazioni gestite
Per i dettagli delle risorse Managedconfigurationssettings, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
list |
GET /enterprises/enterpriseId/products/productId/managedConfigurationsSettings
|
Elenca tutte le impostazioni di configurazione gestite per l'app specificata. |
Autorizzazioni
Per i dettagli sulle risorse di autorizzazioni, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
trova |
GET /permissions/permissionId
|
Recupera i dettagli di un'autorizzazione dell'app Android per mostrarli a un amministratore aziendale. |
Prodotti
Per i dettagli sulle risorse Products, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
approva |
POST /enterprises/enterpriseId/products/productId/approve
|
Approva il prodotto specificato e le eventuali autorizzazioni app pertinenti. Il numero massimo di prodotti che puoi approvare per cliente aziendale è 1000. Per scoprire come utilizzare la versione gestita di Google Play per progettare e creare un layout del negozio per mostrare i prodotti approvati agli utenti, consulta Progettazione del layout dello store. |
generateApprovalUrl |
POST /enterprises/enterpriseId/products/productId/generateApprovalUrl
|
Genera un URL che può essere visualizzato in un iframe per visualizzare le eventuali autorizzazioni di un prodotto. Un amministratore aziendale deve visualizzare queste autorizzazioni e accettarle per conto della propria organizzazione al fine di approvare il prodotto. Gli amministratori devono accettare le autorizzazioni visualizzate interagendo con un elemento UI separato nella console EMM, che a sua volta dovrebbe attivare l'utilizzo di questo URL come proprietà approvalUrlInfo.approvalUrl in una chiamata Products.approve per l'approvazione del prodotto.
Questo URL può essere utilizzato soltanto per visualizzare le autorizzazioni per un massimo di un giorno.
|
trova |
GET /enterprises/enterpriseId/products/productId
|
Recupera i dettagli di un prodotto per mostrarli all'amministratore aziendale. |
getAppRestrictionsSchema |
GET /enterprises/enterpriseId/products/productId/appRestrictionsSchema
|
Recupera lo schema che definisce le proprietà configurabili per questo prodotto. Tutti i prodotti hanno uno schema, ma questo potrebbe essere vuoto se non sono state definite configurazioni gestite. Questo schema può essere utilizzato per compilare una UI che consente a un amministratore di configurare il prodotto. Per applicare una configurazione gestita basata sullo schema ottenuto utilizzando questa API, consulta Configurazioni gestite tramite Play. |
getPermissions |
GET /enterprises/enterpriseId/products/productId/permissions
|
Recupera le autorizzazioni app per Android richieste da questa app. |
list |
GET /enterprises/enterpriseId/products
|
Trova i prodotti approvati che corrispondono a una query oppure tutti i prodotti approvati se non esiste una query. |
annullare l'approvazione |
POST /enterprises/enterpriseId/products/productId/unapprove
|
Annulla l'approvazione del prodotto specificato (e delle eventuali autorizzazioni app pertinenti) |
Chiaviaccount di servizio
Per i dettagli delle risorse Serviceaccountkeys, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/serviceAccountKeys/keyId
|
Rimuove e annulla le credenziali specificate per l'account di servizio associato a questa azienda. L'account di servizio chiamante deve essere stato recuperato chiamando Enterprises.GetServiceAccount e deve essere stato impostato come account di servizio aziendale chiamando Enterprises.SetAccount. |
inserisci |
POST /enterprises/enterpriseId/serviceAccountKeys
|
Genera nuove credenziali per l'account di servizio associato a questa
azienda. L'account di servizio chiamante deve essere stato recuperato chiamando Enterprises.GetServiceAccount e deve essere stato impostato come account di servizio aziendale chiamando Enterprises.SetAccount. Nella risorsa da inserire deve essere compilato solo il tipo della chiave. |
list |
GET /enterprises/enterpriseId/serviceAccountKeys
|
Elenca tutte le credenziali attive per l'account di servizio associato a questa azienda. Vengono restituiti solo l'ID e il tipo di chiave. L'account di servizio chiamante deve essere stato recuperato chiamando Enterprises.GetServiceAccount e deve essere stato impostato come account di servizio aziendale chiamando Enterprises.SetAccount. |
Archiviaclusterlayout
Per i dettagli delle risorse Storelayoutclusters, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
Elimina un cluster. |
trova |
GET /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
Recupera i dettagli di un cluster. |
inserisci |
POST /enterprises/enterpriseId/storeLayout/pages/pageId/clusters
|
Inserisce un nuovo cluster in una pagina. |
list |
GET /enterprises/enterpriseId/storeLayout/pages/pageId/clusters
|
Recupera i dettagli di tutti i cluster nella pagina specificata. |
aggiorna |
PUT /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
Aggiorna un cluster. |
Pagine layout negozio
Per i dettagli delle risorse Storelayoutpages, consulta la pagina sulla rappresentazione della risorsa.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/storeLayout/pages/pageId
|
Elimina una pagina dello store. |
trova |
GET /enterprises/enterpriseId/storeLayout/pages/pageId
|
Recupera i dettagli di una pagina dello store. |
inserisci |
POST /enterprises/enterpriseId/storeLayout/pages
|
Inserisce una nuova pagina dello store. |
list |
GET /enterprises/enterpriseId/storeLayout/pages
|
Recupera i dettagli di tutte le pagine nello store. |
aggiorna |
PUT /enterprises/enterpriseId/storeLayout/pages/pageId
|
Aggiorna i contenuti di una pagina dello store. |
Utenti
Per i dettagli delle risorse utenti, consulta la pagina sulla rappresentazione della risorsa.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/users/userId
|
È stato eliminato un utente gestito da EMM. |
generateAuthenticationToken |
POST /enterprises/enterpriseId/users/userId/authenticationToken
|
Genera un token di autenticazione che il client dei criteri dei dispositivi può utilizzare per eseguire il provisioning dell'account utente gestito da EMM su un dispositivo.
Il token generato è monouso e scade dopo qualche minuto.
Puoi eseguire il provisioning di un massimo di 10 dispositivi per utente. Questa chiamata funziona solo con gli account gestiti da EMM. |
trova |
GET /enterprises/enterpriseId/users/userId
|
Recupera i dettagli di un utente. |
getAvailableProductSet |
GET /enterprises/enterpriseId/users/userId/availableProductSet
|
Recupera l'insieme di prodotti a cui un utente ha il diritto di accedere. |
inserisci |
POST /enterprises/enterpriseId/users
|
Crea un nuovo utente gestito da EMM.
La risorsa Utenti passata nel corpo della richiesta deve includere accountIdentifier e accountType .
Se esiste già un utente corrispondente con lo stesso identificatore di account, l'utente verrà aggiornato con la risorsa. In questo caso è possibile modificare solo il campo |
list |
GET /enterprises/enterpriseId/users
|
Cerca un utente in base all'indirizzo email principale.
Questo attributo è supportato solo per gli utenti gestiti da Google. Non è necessaria la ricerca dell'ID per gli utenti gestiti da EMM, perché l'ID è già restituito nel risultato della chiamata Users.insert.
Parametri di query obbligatori:
|
revokeDeviceAccess |
DELETE /enterprises/enterpriseId/users/userId/deviceAccess
|
Revoca l'accesso a tutti i dispositivi di cui è stato eseguito il provisioning per l'utente. L'utente
non potrà più utilizzare la versione gestita del Play Store su nessuno dei suoi
dispositivi gestiti.
Questa chiamata funziona solo con gli account gestiti da EMM. |
setAvailableProductSet |
PUT /enterprises/enterpriseId/users/userId/availableProductSet
|
Modifica l'insieme di prodotti a cui un utente ha accesso (chiamati prodotti whitelisted). Solo i prodotti approvati o i prodotti precedentemente approvati (prodotti con approvazione revocata) possono essere autorizzati. |
aggiorna |
PUT /enterprises/enterpriseId/users/userId
|
Consente di aggiornare i dettagli di un utente gestito da EMM.
Può essere utilizzato solo con gli utenti gestiti da EMM (non con gli utenti gestiti da Google). Passa i nuovi dettagli nella risorsa Utenti nel corpo della richiesta. È possibile modificare solo il campo displayName . Gli altri campi non devono essere impostati o devono avere il valore attualmente attivo.
|
App web
Per i dettagli delle risorse webapps, consulta la pagina sulla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
URI relativi a https://www.googleapis.com/androidenterprise/v1, se non diversamente specificato | ||
elimina |
DELETE /enterprises/enterpriseId/webApps/webAppId
|
Elimina un'app web esistente. |
trova |
GET /enterprises/enterpriseId/webApps/webAppId
|
Recupera un'app web esistente. |
inserisci |
POST /enterprises/enterpriseId/webApps
|
Crea una nuova app web per l'azienda. |
list |
GET /enterprises/enterpriseId/webApps
|
Recupera i dettagli di tutte le app web per una determinata azienda. |
aggiorna |
PUT /enterprises/enterpriseId/webApps/webAppId
|
Consente di aggiornare un'app web esistente. |