Enterprises

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

Una risorsa Enterprise rappresenta l'associazione tra un EMM e un'organizzazione specifica. L'istanza può essere creata in uno dei due modi seguenti utilizzando questa API:

  • Per i clienti dei domini gestiti di Google, il processo prevede l'utilizzo di Enterprises.enroll e Enterprises.setAccount (insieme agli elementi ottenuti dalla Console di amministrazione e dalla console API di Google) e inviati all'EMM tramite un processo manuale più o meno continuo.
  • Per i clienti con account Google Play gestiti, la procedura prevede l'utilizzo di Enterprises.generateSignupUrl e Enterprises.completeSignup insieme all'interfaccia utente di registrazione della versione gestita di Google Play (meccanismo fornito da Google) per creare l'associazione senza passaggi manuali.
In qualità di EMM, puoi supportare uno o entrambi gli approcci nella tua console EMM. Per maggiori dettagli, vedi Creare un'azienda.

{
  "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
Accetta le notifiche ricevute da Enterprises.PullNotificationSet per impedire il ritorno delle chiamate successive le stesse notifiche.
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
Restituisci 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
Registra un'azienda con l'EMM che gestisce le chiamate.
generateSignupUrl
Genera un URL di registrazione.
trova
Recupera il nome e il dominio di un'azienda.
getServiceAccount
Restituisci un account di servizio e 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
Restituisci 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
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.
pullNotificationSet
Esegue il pull 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
Invia una notifica di prova 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 per l'azienda.
setStoreLayout
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
Annulla la registrazione di un'azienda all'EMM chiamante.