エンタープライズ バインディングを作成する

Enterprise リソースは、組織を Android 管理ソリューションにバインドします。DevicesPolicies はどちらも企業に属しています。1 つの組織に複数のエンタープライズ バインディングを関連付けることができます。たとえば、組織が部門やリージョンごとに個別のエンタープライズ バインディングを必要とする場合があります。

エンタープライズ バインディングを作成する基本的な手順については、クイックスタート ガイドをご覧ください。このページでは、このプロセスについて詳しく説明します。

1. 登録 URL を取得する

signupUrls.create を呼び出して登録 URL を取得し、次の 2 つのパラメータを指定します。

  • callbackUrl: 登録の完了後に設定ウィザードによってリダイレクトされる https URL。通常、これは管理コンソールです。
  • projectId: プロジェクト ID。

レスポンスには urlname が含まれます。url を開き、name をメモします。

2. 企業の IT 管理者が登録フローを完了する

url は、IT 管理者の登録プロセスを案内します。EMM が BTE 登録フローに対して有効になっていない場合は、まだエンタープライズ バインディングに関連付けられていない Gmail アカウントが必要であることを IT 管理者に伝えます。組織が正常に登録されると、登録フローは callbackUrl にリダイレクトされます。enterpriseTokencallbackUrl に追加されます。

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

3. エンタープライズ バインディングを作成する

エンタープライズ バインディングを作成するには、enterprises.create を呼び出します。この方法では、一意のエンタープライズ バインディング ID を作成するだけでなく、特定のバインディング固有の設定を定義できます。たとえば、エンドユーザーに表示する名前またはタイトル(enterpriseDisplayName)、ロゴ(logo)とともに、デバイスのプロビジョニング中に表示される主な色(primaryColor)を設定できます。

次の例では、Java クライアント ライブラリを使用してエンタープライズ バインディングを作成し、その名前を返します。ライブラリの使用方法については、サンプルページをご覧ください。

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) {
  ...
}