Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.
Rappresentazioni delle risorse
Una risorsa Enterprise rappresenta l'associazione tra un EMM e un'organizzazione specifica. Puoi creare un'istanza dell'associazione in due modi diversi utilizzando questa API, come indicato di seguito:
- Per i clienti dei domini gestiti da Google, la procedura prevede l'utilizzo di
Enterprises.enroll
eEnterprises.setAccount
(in combinazione con gli elementi ottenuti dalla Console di amministrazione e dalla console API di Google) e inviata all'EMM tramite una procedura manuale più o meno frequente. - Per i clienti con account Google Play gestiti, la procedura prevede l'utilizzo di
Enterprises.generateSignupUrl
eEnterprises.completeSignup
insieme alla UI di registrazione della versione gestita di Google Play (meccanismo fornito da Google) per creare l'associazione senza passaggi manuali.
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
administrator[] |
list |
Amministratori dell'azienda. Questa opzione è supportata solo per le aziende create tramite il flusso avviato da EMM. |
|
administrator[].email |
string |
L'indirizzo email dell'amministratore. | |
id |
string |
L'ID univoco dell'azienda. |
|
kind |
string |
||
name |
string |
Il nome dell'azienda, ad esempio "Example, Inc". | |
primaryDomain |
string |
Il dominio principale dell'azienda, ad esempio "example.com". |
Metodi
- acknowledgeNotificationSet
- Riconosce le notifiche ricevute da Enterprises.PullNotificationSet per impedire alle chiamate successive di restituire le stesse notifiche.
- completeSignup
- Completa il flusso di registrazione, specificando il token di completamento e il token Enterprise. Questa richiesta non deve essere chiamata più volte per un determinato token Enterprise.
- createWebToken
- Restituisci 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 UI. Per ulteriori informazioni, consulta la documentazione dell'API JavaScript.
- registra
- Registra un'azienda con l'EMM di chiamata.
- generateSignupUrl
- Genera un URL di registrazione.
- recupero
- Recupera il nome e il dominio di un'azienda.
- getServiceAccount
- Restituisci 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 ed EMM e viene eliminato se l'azienda non è associata. Le credenziali contengono dati di chiavi private e non vengono archiviate lato server.
Questo metodo può essere chiamato solo dopo aver chiamato Enterprises.enroll o Enterprises.CompleteSignup e prima di Enterprises.SetAccount; in altri casi verrà restituito un errore.
Le chiamate successive successive alla prima genereranno un nuovo insieme univoco di credenziali e invalideranno le credenziali generate in precedenza.
Una volta che l'account di servizio è associato all'azienda, può essere gestito utilizzando la risorsa serviceAccountKeys. - getStoreLayout
- Restituisci il layout del negozio per l'azienda. Se il layout dello store non è stato impostato, restituisce "basic" come tipo di layout del negozio e nessuna home page.
- list
- 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 da EMM, poiché quest'ultimo apprende l'ID aziendale nel callback specificato nella chiamata Enterprises.generateSignupUrl.
- pullNotificationSet
- Estrae e restituisce una notifica impostata per le aziende associate all'account di servizio autenticato per la richiesta. La notifica potrebbe essere vuota 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 non confermate entro i 20 secondi verranno incluse di nuovo nella risposta a un'altra richiesta PullNotificationSet e quelle che non vengono mai confermate verranno eliminate in base al criterio di sistema Pub/Sub della piattaforma Google Cloud.
È possibile che vengano eseguite più richieste contemporaneamente per recuperare le notifiche, nel qual caso le notifiche in attesa (se presenti) verranno suddivise tra ciascun chiamante, se in attesa.
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 test per convalidare l'integrazione EMM con il servizio Google Cloud Pub/Sub per questa azienda.
- setAccount
- Imposta l'account che verrà utilizzato per l'autenticazione nell'API come azienda.
- setStoreLayout
- Imposta il layout del negozio per l'azienda. Per impostazione predefinita, storeLayoutType è impostato su "base" e il layout di base del negozio è attivato. Il layout di base contiene solo le app approvate dall'amministratore e che sono state aggiunte al set di prodotti disponibile per un utente (mediante la chiamata setAvailableProductSet). Le app nella pagina sono ordinate in base al valore dell'ID prodotto. Se crei un layout dello store personalizzato (impostando storeLayoutType = "custom" e impostando una home page), il layout di base dello store viene disattivato.
- annullare la registrazione
- Annulla la registrazione di un'azienda all'EMM di chiamata.