Enterprises

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

Rappresentazioni delle risorse

Una risorsa Enterprises rappresenta il binding tra una soluzione EMM e un'organizzazione specifica. Questo binding può essere istanziato in due modi diversi utilizzando questa API come segue:

• Per i clienti con domini gestiti da Google, la procedura prevede l'utilizzo di Enterprises.enroll e Enterprises.setAccount (in combinazione con gli artefatti ottenuti dalla Console di amministrazione e dalla console Google API) e l'invio all'EMM tramite una procedura più o meno manuale.
• Per i clienti con account Google Play gestiti, la procedura prevede l'utilizzo di Enterprises.generateSignupUrl e Enterprises.completeSignup in combinazione con la UI di registrazione di Google Play gestito (meccanismo fornito da Google) per creare il binding senza passaggi manuali.

In qualità di EMM, puoi supportare uno o entrambi gli approcci nella tua console EMM. Per maggiori dettagli, vedi Creare un'organizzazione.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nome proprietà	Valore	Descrizione	Note
administrator[]	list	Amministratori dell'azienda. Questa funzionalità è supportata solo per le aziende create tramite il flusso avviato da EMM.
administrator[].email	string	L'indirizzo email dell'amministratore.
enterpriseType	string	Il tipo di impresa. I valori accettati sono: "enterpriseTypeUnspecified" "managedGoogleDomain" "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings	nested object	Impostazioni per l'autenticazione utente fornita da Google.
googleAuthenticationSettings.createdAt	nested object	Timestamp della creazione o della modifica iniziale delle impostazioni.
googleAuthenticationSettings.createdAt.nanos	integer	Frazioni di secondo non negative con risoluzione in nanosecondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.
googleAuthenticationSettings.createdAt.seconds	long	Rappresenta i secondi di tempo UTC dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z inclusi.
googleAuthenticationSettings.dedicatedDevicesAllowed	string	Indica se i dispositivi dedicati sono consentiti. I valori accettati sono: "allowed" "dedicatedDevicesAllowedUnspecified" "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired	string	Indica se è richiesta l'autenticazione Google. I valori accettati sono: "googleAuthenticationRequiredUnspecified" "notRequired" "required"
googleAuthenticationSettings.updatedAt	nested object	Timestamp dell'ultima modifica delle impostazioni.
googleAuthenticationSettings.updatedAt.nanos	integer	Frazioni di secondo non negative con risoluzione in nanosecondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.
googleAuthenticationSettings.updatedAt.seconds	long	Rappresenta i secondi di tempo UTC dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z inclusi.
id	string	L'ID univoco dell'azienda.
id	string	L'ID univoco dell'azienda.
kind	string
managedGoogleDomainType	string	Il tipo di dominio Google gestito I valori accettabili 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

Riconosce le notifiche ricevute da Enterprises.PullNotificationSet per impedire che le chiamate successive restituiscano le stesse notifiche.

completeSignup

Completa il flusso di registrazione specificando il token di completamento e il token aziendale. Questa richiesta non deve essere chiamata più volte per un determinato token aziendale.

createWebToken

Restituisce un token univoco per accedere a una UI incorporabile. Per generare un'interfaccia utente web, passa il token generato all'API JavaScript di Google Play gestito. Ogni token può essere utilizzato per avviare una sola sessione dell'interfaccia utente. Per ulteriori informazioni, consulta la documentazione dell'API JavaScript.

enroll

Registra un'azienda con l'EMM chiamante.

generateEnterpriseUpgradeUrl

Genera un URL di upgrade dell'azienda per eseguire l'upgrade di un'azienda con account Google Play gestiti esistente a un dominio Google gestito. Per maggiori dettagli, consulta la guida all'upgrade di un'azienda.

generateSignupUrl

Genera un URL di registrazione.

get

Recupera il nome e il dominio di un'azienda.

getServiceAccount

Restituisce un service account e le relative credenziali. Il service account può essere associato all'azienda chiamando setAccount. Il service account è univoco per questa azienda ed EMM e verrà eliminato se l'azienda viene scollegata. Le credenziali contengono dati della chiave privata e non vengono archiviate sul server.

Questo metodo può essere chiamato solo dopo aver chiamato Enterprises.Enroll o Enterprises.CompleteSignup e prima di Enterprises.SetAccount; in altri momenti 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, il service account può essere gestito utilizzando la risorsa serviceAccountKeys.

Nota:dopo aver creato una chiave, potresti dover attendere 60 secondi o più prima di eseguire un'altra operazione con la chiave. Se provi a eseguire un'operazione con la chiave subito dopo averla creata e ricevi un errore, puoi riprovare la richiesta con backoff esponenziale

.

getStoreLayout

Restituisce il layout dello store per l'organizzazione. Se il layout dello store non è stato impostato, restituisce "basic" come tipo di layout dello store e nessuna homepage.

list

Cerca un'azienda in base al nome di dominio. Questa funzionalità è 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é EMM apprende l'ID azienda nel callback specificato nella chiamata Enterprises.generateSignupUrl.

pullNotificationSet

Recupera e restituisce un insieme di notifiche per le aziende associate all'account di servizio autenticato per la richiesta. Il set di notifiche potrebbe 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 l'insieme di notifiche non sia vuoto.
Le notifiche che non vengono riconosciute entro 20 secondi verranno nuovamente incluse nella risposta a un'altra richiesta PullNotificationSet e quelle che non vengono mai riconosciute verranno eliminate in base alle norme del sistema Google Cloud Pub/Sub.
Potrebbero essere eseguite più richieste contemporaneamente per recuperare le notifiche, nel qual caso le notifiche in attesa (se presenti) verranno suddivise tra i vari chiamanti, se presenti.
Se non sono presenti notifiche, viene restituito un elenco di notifiche vuoto. Le richieste successive potrebbero restituire più notifiche una volta 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 all'API come l'azienda.

setStoreLayout

Imposta il layout dello store per l'azienda. Per impostazione predefinita, storeLayoutType è impostato su "basic" e il layout di base del negozio è attivato. Il layout di base contiene solo le app approvate dall'amministratore e aggiunte al set di prodotti disponibili per un utente (utilizzando 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 dello Store di base viene disattivato.

annullare la registrazione

Annulla la registrazione di un'azienda al provider EMM per le chiamate.