Importante:non accettiamo più nuove registrazioni per l'API Play EMM. Scopri di più.

Questa pagina è stata tradotta dall'API Cloud Translation.

Enterprises

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Una risorsa Enterprises rappresenta il legame tra un EMM e un'organizzazione specifica. Questa associazione può essere creata in due modi diversi utilizzando questa API come segue:

Per i clienti con dominio gestito da Google, il processo prevede l'utilizzo di Enterprises.enroll e Enterprises.setAccount (in combinazione con gli elementi ottenuti dalla Console di amministrazione e dalla Console API Google) e l'invio all'EMM tramite una procedura più o meno manuale.
Per i clienti con account della versione gestita di Google Play, la procedura prevede l'utilizzo di Enterprises.generateSignupUrl e Enterprises.completeSignup in combinazione con l'interfaccia utente di registrazione della versione gestita di Google Play (meccanismo fornito da Google) per creare il collegamento senza passaggi manuali.

In qualità di fornitore EMM, puoi supportare uno o entrambi gli approcci nella tua console EMM. Per informazioni dettagliate, vedi Creare un'azienda.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nome proprietà	Valore	Descrizione
`administrator[]`	`list`	Amministratori dell'azienda. Questa opzione è supportata solo per le aziende create tramite il flusso avviato dall'EMM.
`administrator[].email`	`string`	L'indirizzo email dell'amministratore.
`enterpriseType`	`string`	Il tipo di azienda. I valori accettati sono: "`enterpriseTypeUnspecified`" "`managedGoogleDomain`" "`managedGooglePlayAccountsEnterprise`"
`id`	`string`	L'ID univoco dell'azienda.
`kind`	`string`
`managedGoogleDomainType`	`string`	Il tipo di dominio Google gestito I valori accettati sono: "`managedGoogleDomainTypeUnspecified`" "`typeDomain`" "`typeTeam`"
`name`	`string`	Il nome dell'azienda, ad esempio "Example, Inc".
`primaryDomain`	`string`	Il dominio principale dell'azienda, ad esempio "example.com".

Metodi

acknowledgeNotificationSet: Acconsente alle notifiche ricevute da Enterprises.PullNotificationSet per impedire alle chiamate successive di restituire le stesse notifiche.
completeSignup: Completa la procedura di registrazione specificando il token di completamento e il token dell'azienda. Questa richiesta non deve essere chiamata più volte per un determinato token Enterprise.
createWebToken: Restituisce un token univoco per accedere a un'interfaccia utente incorporabile. Per generare un'UI 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.
registrarsi: Registra un'azienda con l'EMM che effettua la chiamata.
generateSignupUrl: Genera un URL di registrazione.
get: Recupero del nome e del dominio di un'azienda.
getServiceAccount: Restituisce un account di servizio e le relative credenziali. L'account di servizio puoi essere associato all'azienda chiamando setAccount. L'account di servizio è univoco per questa azienda e per questo provider EMM e verrà eliminato se l'azienda non è associata. Le credenziali contengono dati della chiave privata e non vengono memorizzate sul lato server.

Questo metodo può essere chiamato solo dopo aver chiamato Enterprises.Enroll o Enterprises.CompleteSignup e prima di Enterprises.SetAccount; in altri casi restituirà un errore.

Le chiamate successive alla prima genereranno un nuovo insieme univoco di credenziali e invalideranno quelle generate in precedenza.

Una volta associato all'azienda, l'account di servizio può essere gestito utilizzando la risorsa serviceAccountKeys.
getStoreLayout: Restituisce il layout del negozio per l'azienda. Se il layout del negozio non è stato impostato, viene restituito "base" come tipo di layout del negozio e non viene visualizzata alcuna home page.
list: Cerca un'azienda tramite il 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 dall'EMM, poiché l'EMM acquisisce l'ID azienda nel callback specificato nella chiamata Enterprises.generateSignupUrl.
pullNotificationSet: Estrae e restituisce un insieme di notifiche per le aziende associate all'account di servizio autenticato per la richiesta. L'insieme di notifiche può essere vuoto se non sono presenti notifiche in attesa.
Un insieme di notifiche restituito deve essere confermato entro 20 secondi chiamando Enterprises.AcknowledgeNotificationSet, a meno che il insieme di notifiche non sia vuoto.
Le notifiche che non vengono confermate entro 20 secondi verranno nuovamente incluse nella risposta a un'altra richiesta PullNotificationSet e quelle che non vengono mai confermate verranno infine eliminate in base alle norme del sistema Pub/Sub della piattaforma Google Cloud.
Per recuperare le notifiche potrebbero essere eseguite più richieste contemporaneamente, nel qual caso le notifiche in attesa (se presenti) verranno suddivise tra ciascun chiamante.
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 prova per convalidare l'integrazione di EMM con il servizio Google Cloud Pub/Sub per l'azienda.
setAccount: Imposta l'account che verrà utilizzato per autenticarsi nell'API come azienda.
setStoreLayout: Imposta il layout del negozio per l'azienda. Per impostazione predefinita, il valore di storeLayoutType è impostato su "base" e il layout della vetrina di base è attivato. Il layout di base contiene solo le app approvate dall'amministratore e aggiunte all'insieme di prodotti disponibili per un utente (utilizzando la chiamata setAvailableProductSet). Le app nella pagina sono ordinate in base al valore del loro ID prodotto. Se crei un layout della vetrina personalizzato (impostando storeLayoutType = "custom" e impostando una home page), il layout della vetrina di base viene disattivato.
annullare la registrazione: Annullare la registrazione di un'azienda dal provider EMM che effettua la chiamata.