Crea un'azienda

Una risorsa Enterprise associa un'organizzazione alla tua soluzione Android Management. Devices e Policies appartengono entrambi a un'azienda. In genere, una singola risorsa aziendale è associata a una singola organizzazione. Tuttavia, puoi creare più aziende per la stessa organizzazione in base alle loro esigenze. Ad esempio, un'organizzazione potrebbe volere imprese separate per i diversi reparti o aree geografiche.

I passaggi di base per creare un'azienda sono descritti nella Guida rapida. Questa pagina illustra il processo in modo più dettagliato. Esistono due modi per creare un'impresa:

  • Azienda gestita dal cliente: Si tratta del metodo consigliato per la creazione di un'azienda. Non impostare il parametro di ricerca agreementAccepted e il campo contactInfo durante la chiamata del metodo "enterprises.create".
  • Azienda gestita da EMM: non è il metodo preferito per creare un'impresa, ma è ancora possibile creare e gestire un'impresa gestita da EMM utilizzando questo metodo. Imposta il parametro di ricerca agreementAccepted e il campo contactInfo quando chiami il metodo "enterprises.create".

Aziende gestite dal cliente

Questo è il metodo preferito per creare un'azienda ed è ulteriormente spiegato come segue:

1. Recuperare l'URL di registrazione

Richiama signupUrls.create per recuperare l'URL di registrazione e specificare i due parametri seguenti:

  • callbackUrl: un URL https a cui la configurazione guidata reindirizza dopo il completamento della registrazione aziendale. In genere si tratta della tua console di gestione.
  • projectId: il tuo ID progetto.

La risposta contiene url e name. Apri url e prendi nota di name.

2. L'amministratore IT aziendale completa la procedura di registrazione

url guida l'amministratore aziendale nella procedura di registrazione aziendale. Ha bisogno di un account Gmail non ancora associato a un'azienda. Dopo aver registrato l'azienda, il flusso di registrazione reindirizza al tuo callbackUrl. Verrà aggiunto un elemento enterpriseToken al callbackUrl.

Esempio

https://example.com/?enterpriseToken=EAH2pBTtGCs2K28dqhq5uw0uCyVzYMqGivap4wdlH7KNlPtCmlC8uyl

3. Crea un'azienda

Per creare un'azienda, chiama enterprises.create. Oltre a creare un ID aziendale univoco, questo metodo consente di definire alcune impostazioni specifiche. Ad esempio, puoi impostare il colore prevalente visualizzato durante il provisioning del dispositivo (primaryColor) e il nome o il titolo (enterpriseDisplayName) e il logo (logo) che verranno mostrati agli utenti finali.

Esempio

Negli esempi seguenti viene utilizzata la libreria client Java per creare un'impresa e restituirne il nome. Per ulteriori dettagli sull'utilizzo della libreria, consulta la pagina Esempio.

private String createEnterprise(AndroidManagement androidManagementClient)
    throws IOException {
  SignupUrl signupUrl =
      androidManagementClient
          .signupUrls()
          .create()
          .setProjectId("myProject")
          .setCallbackUrl("https://example.com/myEmmConsole")
          .execute();

  String enterpriseToken = displayUrlToAdmin(signupUrl.getUrl());

  Enterprise enterprise =
      androidManagementClient
          .enterprises()
          .create(new Enterprise())
          .setProjectId("myProject")
          .setSignupUrlName(signupUrl.getName())
          .setEnterpriseToken(enterpriseToken)
          .execute();

  return enterprise.getName();
}

/**
 * Displays the signup URL to the admin and returns the enterprise token which
 * is generated after the admin goes through the signup flow. This functionality
 * must be implemented by your management console.
 */
private String displayUrlToAdmin(String url) {
  ...
}

Aziende gestite da EMM

Questo non è più il metodo consigliato per creare un'azienda. Con questo metodo, le EMM hanno il controllo sull'intero ciclo di vita di un'azienda. Assicurati di rivedere i Termini di servizio, che includono informazioni quali informazioni da raccogliere, e gli obblighi verso i tuoi clienti per questa funzionalità, per garantire che la tua soluzione soddisfi tutti i requisiti dell'API. Alcuni di questi dettagli sono evidenziati di seguito:

1. Prerequisiti

  1. Raccogli l'indirizzo email dell'amministratore aziendale.
  2. Consenti al tuo cliente di fornirti i dati di contatto del responsabile della protezione dei dati e del rappresentante dell'Unione Europea. Devi inoltre consentire al cliente di modificare i dati di contatto e, in caso affermativo, di comunicare a Google i nuovi dati di contatto (con enterprises.patch).
  3. Mostrare all'amministratore aziendale il Contratto relativo alla versione gestita di Google Play e registrare l'identità del cliente e dell'utente, nonché la data e l'ora dell'accettazione nel proprio sistema.

2. Crea l'impresa

Per creare un'azienda, chiama enterprises.create, trasmettendo i seguenti valori:

  • Imposta agreementAccepted su true in base al completamento del passaggio 3 nei prerequisiti.
  • Imposta contactInfo nella risorsa Enterprise utilizzando i dettagli di contatto raccolti dall'amministratore aziendale nei passaggi 1 e 2. Tieni presente che contactEmail è obbligatorio. che possono includere: 
    {
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
  • Oltre a creare un ID aziendale univoco, questo metodo consente di definire alcune impostazioni specifiche. Ad esempio, puoi impostare il colore prevalente per essere visualizzato nell'interfaccia utente dell'app di gestione dei dispositivi (primaryColor), insieme al nome o al titolo (enterpriseDisplayName) e al logo (logo) mostrati agli utenti finali.

Sei responsabile del ciclo di vita (creazione, aggiornamento ed eliminazione) dell'azienda. Ora puoi aggiornarlo utilizzando enterprises.patch ed eliminarlo utilizzando enterprises.delete. Devi eliminare l'azienda quando il tuo cliente interrompe il rapporto con te.

3. Aggiornare ed elencare le aziende

Per modificare contactInfo per un'azienda, chiama enterprises.patch e imposta contactInfo nella risorsa Enterprise. Tieni presente quanto segue:

  • Se update_mask include contactInfo e trasmetti un valore contactInfo vuoto, la chiamata non andrà a buon fine.
  • Se update_mask non è impostato e contactInfo viene omesso, non verrà apportata alcuna modifica a contactInfo.

Per recuperare un elenco di tutte le aziende gestite da EMM, chiama enterprises.list. La risposta contiene solo i seguenti campi per ogni azienda:

  • name: il nome dell'azienda nel formato enterprises/{enterpriseId}.
  • enterpriseDisplayName: il nome dell'azienda mostrata agli utenti.

Per recuperare gli altri campi, chiama enterprises.get con l'name specifico di un'azienda.

Esempio

Negli esempi seguenti viene utilizzata la libreria client Java per creare un'impresa e restituirne il nome. Per ulteriori dettagli sull'utilizzo della libreria, consulta la pagina Esempio.

Per creare un'azienda:

private String createEnterprise(AndroidManagement androidManagementClient)
    throws IOException {
  ContactInfo contactInfo = new ContactInfo();
  contactInfo.setContactEmail("contact@example.com");
  contactInfo.setDataProtectionOfficerName("John Doe");
  contactInfo.setDataProtectionOfficerEmail("dpo@example.com");
  contactInfo.setDataProtectionOfficerPhone("+33 1 99 00 98 76 54");
  contactInfo.setEuRepresentativeName("Jane Doe");
  contactInfo.setEuRepresentativeEmail("eurep@example.com");
  contactInfo.setEuRepresentativePhone("+33 1 99 00 12 34 56");

  Enterprise enterprise = new Enterprise();
  enterprise.setEnterpriseDisplayName("Example Enterprise");

  Enterprise enterprise =
      androidManagementClient
          .enterprises()
          .create(enterprise)
          .setProjectId("myProject")
          .setContactInfo(contactInfo)
          .setAgreementAccepted(true)
          .execute();

  return enterprise.getName();
}

Per eliminare un'azienda:

private void deleteEnterprise(AndroidManagement androidManagementClient, String enterpriseName)
    throws IOException {
  Enterprise enterprise = new Enterprise();
  // The enterprise name is in the form of enterprises/{enterpriseId}
  enterprise.setName(enterpriseName);

  Enterprise enterprise =
      androidManagementClient
          .enterprises()
          .delete(enterprise)
          .execute();
}