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 .
- Managedconfigurationsfordevice .
- Configurazioni gestiteper l'utente .
- Managedconfigurationssettings .
- Autorizzazioni .
- Prodotti .
- Serviceaccountkeys .
- Archiviaclusterlayout .
- 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 da è stato generato l'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 è attivo o disattivata. Lo stato del dispositivo ha effetto solo se vengono applicati i criteri EMM su Android nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e l'accesso è consentito a tutti i dispositivi 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 vengono applicati i criteri EMM su Android nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e l'accesso è consentito a tutti i dispositivi 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 assicurarti che il criterio venga applicato correttamente, devi evitare di accedere a Google Play impostando il allowed_accounts nella configurazione gestita per Google
pacchetto Google Play. Vedi le limitazioni
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 il ritorno delle chiamate successive le stesse notifiche. |
completeSignup |
POST /enterprises/completeSignup
|
Completa il flusso di registrazione specificando il token di completamento e Token aziendale. Questa richiesta non deve essere richiamata più volte per una determinata azienda Token. |
createWebToken |
POST /enterprises/enterpriseId/createWebToken
|
Restituisce un token univoco per accedere a un'interfaccia utente incorporabile. Per generare un nell'interfaccia utente web, passa il token generato al codice JavaScript della versione gestita di Google Play tramite Google Cloud CLI o tramite l'API Compute Engine. Ogni token può essere utilizzato solo per avviare una sessione dell'interfaccia utente. Consulta le documentazione dell'API JavaScript per ulteriori informazioni. |
registra |
POST /enterprises/enroll
|
Registra un'azienda con l'EMM che gestisce le chiamate.
Parametri di ricerca 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. Account di servizio
può essere associato all'azienda chiamando setAccount. Account di servizio
è univoco per questa azienda e per l'EMM e verrà eliminato se l'azienda
non è legato. Le credenziali contengono dati di chiave privata e non vengono archiviate.
lato server.
e Questo metodo può essere chiamato solo dopo aver chiamato Enterprises.Registrati o Enterprises.CompleteSignup e prima Enterprises.SetAccount; altre volte lo restituirà un errore. e Le chiamate successive alla prima genereranno un nuovo insieme univoco credenziali e invalida quelle generate in precedenza. e Una volta associato l'account di servizio all'azienda, puoi gestirlo 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 del negozio e nessun homepage. |
list |
GET /enterprises
|
Cerca un'azienda per nome di dominio.
Questa opzione è supportata solo per le aziende create tramite il prompt avviato da Google
flusso di creazione di contenuti. La ricerca dell'ID non è necessaria per le aziende create tramite
il flusso avviato da EMM, poiché quest'ultimo apprende l'ID azienda nella
specificato nella chiamata Enterprises.generateSignupUrl.
Parametri di ricerca obbligatori:
|
pullNotificationSet |
POST /enterprises/pullNotificationSet
|
Estrae e restituisce un set di notifiche per le aziende associate a
l'account di servizio autenticato per la richiesta. La notifica impostata può
essere vuota se non ci sono notifiche in attesa.
Una serie di notifiche restituita deve essere confermata entro 20 secondi chiamando Enterprises.AcknowledgeNotificationSet, a meno che il set di notifiche è vuoto. Le notifiche che non vengono confermate entro 20 secondi verranno e alla fine essere nuovamente inclusi nella risposta a un altro PullNotificationSet. e quelli che non vengono mai riconosciuti saranno eliminati in base ai criteri di sistema Pub/Sub della piattaforma Google Cloud. Potrebbero essere eseguite più richieste contemporaneamente per recuperare delle notifiche, nel qual caso le eventuali notifiche in attesa verranno divisa tra ciascun chiamante, se presente. Se non sono presenti notifiche, viene restituito un elenco di notifiche vuoto. Le richieste successive potrebbero restituire più notifiche una volta che 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 l'autenticazione nell'API come per l'azienda. |
setStoreLayout |
PUT /enterprises/enterpriseId/storeLayout
|
Imposta il layout del negozio per l'azienda. Per impostazione predefinita, storeLayoutType è impostato su "di base" e il layout di base del negozio è abilitato. Le basi contiene soltanto le app approvate dall'amministratore che hanno all'insieme di prodotti disponibili per un utente (utilizzando setAvailableProductSet). Le app nella pagina sono ordinate in ordine di il valore dell'ID prodotto. Se crei un layout del negozio personalizzato (tramite l'impostazione storeLayoutType = "custom" e impostando una home page), lo store di base è disattivato. |
annullare l'iscrizione |
POST /enterprises/enterpriseId/unenroll
|
Annulla la registrazione di un'azienda all'EMM che chiama. |
Diritti
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 installazioni delle risorse, 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 fino a quando
viene effettivamente rimosso.
|
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
|
Richieste di installazione dell'ultima versione di un'app su un dispositivo. Se l'app è già installato, viene aggiornato all'ultima versione se necessaria. |
Managedconfigurationsfordevice
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 l'elemento specificato dispositivo. |
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 per il 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 di un'app per 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 il utente. |
trova |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
Recupera i dettagli di una configurazione gestita per utente per un'app per il all'utente specificato. |
list |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser
|
Elenca tutte le configurazioni gestite per utente per l'utente specificato. Solo dell'ID impostato. |
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 un mcmId
e le eventuali variabili di configurazione associate nella richiesta. In alternativa,
tutti i provider EMM possono applicare configurazioni gestite passando un elenco di
proprietà.
|
Managedconfigurationssettings
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 uno store per mostrare i prodotti approvati agli utenti, consulta Design Layout del negozio. |
generateApprovalUrl |
POST /enterprises/enterpriseId/products/productId/generateApprovalUrl
|
Genera un URL che può essere visualizzato in un iframe per visualizzare
autorizzazioni (se presenti) di un prodotto. Deve essere visualizzato da un amministratore aziendale
autorizzazioni e accettarle per conto della propria organizzazione al fine
approvare quel prodotto. Gli amministratori devono accettare le autorizzazioni visualizzate entro il interagendo con un elemento UI separato nella console EMM, che a sua volta dovrebbe attivare l'utilizzo di questo URL come approvalUrlInfo.approvalUrl proprietà in una
Products.approve per approvare il 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 l'elemento prodotto. Tutti i prodotti hanno uno schema, ma questo potrebbe essere vuoto in caso contrario sono state definite le configurazioni gestite. Questo schema può essere utilizzato compilare una UI che consente a un amministratore di configurare il prodotto. Applicare una configurazione gestita in base allo schema ottenuto utilizzando questa sull'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 o tutti i prodotti approvati se non ci sono query. |
annullare l'approvazione |
POST /enterprises/enterpriseId/products/productId/unapprove
|
Annulla l'approvazione del prodotto specificato (e delle eventuali autorizzazioni dell'app pertinenti) |
Serviceaccountkeys
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 invalida le credenziali specificate per l'account di servizio associati a questa azienda. L'account di servizio per le chiamate deve essere stato recuperata chiamando Enterprises.GetServiceAccount e deve essere stata impostata come account di servizio aziendale chiamando Enterprises.SetAccount. |
inserisci |
POST /enterprises/enterpriseId/serviceAccountKeys
|
Genera nuove credenziali per l'account di servizio associato
per l'azienda. L'account di servizio chiamante deve essere stato recuperato chiamando
Enterprises.GetServiceAccount e deve essere stato impostato come l'azienda
l'account di servizio
chiamando Enterprises.SetAccount. Nella risorsa deve essere compilato solo il tipo della chiave per inserito. |
list |
GET /enterprises/enterpriseId/serviceAccountKeys
|
Elenca tutte le credenziali attive per l'account di servizio associato a questa per l'azienda. Vengono restituiti solo l'ID e il tipo di chiave. Il servizio di chiamata l'account 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. |
Storelayoutpages
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 utente, 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 dall'EMM specificato 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
|
Consente di recuperare 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 passati nel corpo della richiesta devono includere un 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 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. La ricerca dell'ID non è
necessaria per gli utenti gestiti da EMM perché l'ID è già restituito nella
il risultato della chiamata Users.insert.
Parametri di ricerca 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ù usare la versione gestita del Play Store sui 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 può accedere (indicati come prodotti autorizzati). Solo i prodotti che approvato o prodotti precedentemente approvati (prodotti con approvazione revocata) possono essere inclusi nella lista consentita. |
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). Trasmetti i nuovi dettagli nel Utenti risorsa nel corpo della richiesta. Solo il campo displayName
possono essere modificate. Gli altri campi non devono essere impostati o devono presentare
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. |