Enterprise
リソースは、組織を Android 管理ソリューションにバインドします。Devices
と Policies
はどちらも企業に属しています。1 つの組織に複数のエンタープライズ バインディングを関連付けることができます。たとえば、組織が部門やリージョンごとに個別のエンタープライズ バインディングを必要とする場合があります。
エンタープライズ バインディングを作成する基本的な手順については、クイックスタート ガイドをご覧ください。このページでは、このプロセスについて詳しく説明します。
1. 登録 URL を取得する
signupUrls.create
を呼び出して登録 URL を取得し、次の 2 つのパラメータを指定します。
callbackUrl
: 登録の完了後に設定ウィザードによってリダイレクトされる https URL。通常、これは管理コンソールです。projectId
: プロジェクト ID。
レスポンスには url
と name
が含まれます。url
を開き、name
をメモします。
2. 企業の IT 管理者が登録フローを完了する
url
は、IT 管理者の登録プロセスを案内します。EMM が BTE 登録フローに対して有効になっていない場合は、まだエンタープライズ バインディングに関連付けられていない Gmail アカウントが必要であることを IT 管理者に伝えます。組織が正常に登録されると、登録フローは callbackUrl
にリダイレクトされます。enterpriseToken
は callbackUrl
に追加されます。
例
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) { ... }