API Reference

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

  1. Dispositivi .
  2. Aziende .
  3. Diritti .
  4. Licenze di gruppo .
  5. Utenti licenze di gruppo .
  6. Installazioni .
  7. Managedconfigurationsfordevice .
  8. Configurazioni gestiteper l'utente .
  9. Managedconfigurationssettings .
  10. Autorizzazioni .
  11. Prodotti .
  12. Serviceaccountkeys .
  13. Archiviaclusterlayout .
  14. Storelayoutpages .
  15. Utenti .
  16. 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: token

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: domain

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 displayName può essere modificato.

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: email

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.