このページは Cloud Translation API によって翻訳されました。

アプリの配布

以降のセクションでは、managed Google Play ストアでのアプリの配信について説明します。

アプリをインストールする

このポリシーを使用すると、Google Play ストアからデバイスに Android アプリをインストールできます。この機能を使用するには、インストールするアプリのパッケージ名を把握する必要があります。アプリのパッケージ名を確認するには、次の 2 つの方法があります。

アプリのパッケージ名は、Google Play ストアのページの URL に記載されています。たとえば、Google Chrome アプリのページの URL は次のとおりです。
```
https://play.google.com/store/apps/details?id=com.android.chrome
```
で、パッケージ名は com.android.chrome です。
EMM コンソールに managed Google Play iframe を埋め込むと、お客様が Google Play ストアをブラウジングできるようになります。お客様が iframe でアプリを選択すると、EMM コンソールはイベントのパッケージ名を受け取ります。

その後、デバイスのポリシーでアプリを追加できます。

"applications":[
   {
      "installType":"FORCE_INSTALLED",
      "packageName":"com.android.chrome",
   },
],

デバイスにポリシーを適用すると、アプリはデバイスにインストールされるか、デバイスの managed Google Play ストアに追加されます。

クローズドテスト用にアプリを配布する

Google Play Console では、アプリデベロッパーはクローズドリリース（クローズドトラック）を作成して、一連のテスターでアプリのプレリリース版をテストできます。これはクローズドテストと呼ばれます。クローズドトラック配信をサポートすることで、組織はサードパーティ製アプリだけでなく、社内で開発した限定公開アプリもテストできます。

Google Play Console でクローズドテストを設定する際、アプリデベロッパーは最大 100 個の組織（enterprises）をターゲットに設定できます。Android Management API を使用して、企業をターゲットとするクローズドトラックを取得し、ポリシーを使用してこれらのクローズドトラックをデバイスに配信できます。

クローズドテストの対象となるアプリ

クローズドテストを設定する前に、アプリデベロッパーはアプリが次の要件を満たしていることを確認する必要があります。

アプリの製品版が Google Play（限定公開アプリの場合は managed Google Play）で公開されている
Google Play Console で、アプリの [詳細設定] ページで [管理対象の Google Play] が有効になっている。
アプリのクローズドバージョンがバージョンコードの要件を満たしている。

クローズドテストに企業を追加する

クローズドテストをセットアップする際に、アプリデベロッパーは組織 ID を追加することで、組織にクローズドテストへのアクセス権を付与できます。お客様は、次の手順に沿って組織 ID を確認できます。

管理者アカウントで managed Google Play にログインします。
[管理者設定] をクリックします。
[組織の情報] 欄から組織 ID の文字列をコピーし、デベロッパーに送信します。

限定公開アプリの場合は、デベロッパーはアプリの [詳細設定] ページの [managed Google Play] タブに、参加する各企業の組織 ID を追加する必要があります。手順については、Play Console から限定公開アプリを公開するをご覧ください。

クローズドトラックをユーザーに配布する

指定したアプリで企業が利用できるトラックのリストを取得するには、enterprises.applications を呼び出します。レスポンスに含まれる appTrackInfo[] リストには、特定のアプリについて次の情報が含まれます。

trackId: トラックの一意の識別子。アプリのトラック情報を表示する Google Play Console のページの URL の releaseTrackId から取得されます。
trackAlias: トラックの判読可能な名前。Google Play Console で変更できます。

ユーザーのデバイスにクローズドトラックをインストールするには、デバイスのポリシーで accessibleTrackIds を指定します。

"applications":[
   {
      "installType":"AVAILABLE",
      "packageName":"com.google.android.gm",
      "accessibleTrackIds":[
          "123456",
          "789101"
       ]
   },
],

ポリシーに同じアプリの複数のトラックが含まれている場合（上記の例のように）、ポリシーはバージョンコードが最も高いトラックをインストールします。

次のシナリオなど、特定のシナリオでは、trackIds は enterprises.applications 呼び出しから自動的に削除されます。

トラックの APK が別のトラックまたは製品版に昇格します。
製品版がトラックよりも高いバージョンに更新されている。
デベロッパーがトラックを停止します。

managed Google Play iframe

managed Google Play iframe を使用すると、managed Google Play を EMM コンソールに直接埋め込み、統合されたモビリティ管理エクスペリエンスをお客様に提供できます。

managed-play-iframe — **図 1.** managed Google Play iframe

iframe には、タイトルバーと展開可能なサイドメニューが含まれています。メニューから、次のページに移動できます。

アプリを検索する: IT 管理者は、Google Play アプリを検索、閲覧、アプリの詳細の表示、アプリの選択を行うことができます。
限定公開アプリ: IT 管理者は、企業向けの限定公開アプリを公開して管理できます。
ウェブアプリ: IT 管理者は、ウェブサイトのショートカットをアプリとして公開して配布できます。
アプリを整理する: IT 管理者は、ユーザーのデバイスの Google Play ストアアプリでアプリを整理する方法を設定できます。

機能

このセクションでは、管理対象の Google Play iframe で利用可能な機能について説明します。iframe を埋め込んでこれらの機能を実装する方法については、iframe をコンソールに追加するをご覧ください。

アプリを検索

[アプリを検索] ページ（図 1 を参照）では、IT 管理者が Google Play アプリを検索、ブラウジング、選択できます。

ページのタイトルバーにある検索ボックスは、デフォルトで有効になっています。検索ボックスは、自動補完などの機能をサポートし、Google Play で公開されているアプリの結果を返します。検索結果が iframe 内に表示されます。

限定公開アプリ

[限定公開アプリ] ページでは、IT 管理者が EMM コンソールから直接限定公開アプリを公開、管理できます。IT 管理者が限定公開アプリの公開を効率化できるように、このページには次の機能が用意されています。

エンタープライズに代わって Google Play Console アカウントをサイレントで作成し、IT 管理者に管理者権限を付与します。
アプリの公開に必要だった Play Console の登録料（25 米ドル）が免除されます。
必要なのは、アプリの APK とタイトルのみです。
アプリの公開が 10 分以内に完了します（Google Play Console では 2 時間）。
注: [限定公開アプリ] ページから公開したアプリを一般公開することはできません。

IT 管理者が iframe で初めてアプリを公開すると、iframe によって企業の代わりに Play Console アカウントが自動的に作成されます。高度な編集を行うと、Google アカウントでログインするよう求められます。これは任意の Google アカウント（Gmail、Cloud Identity など）にできます。この Google アカウントは、企業の Google Play Console アカウントの管理者として追加されます。その後、IT 管理者は Google アカウントを使用して Google Play Console に直接ログインし、次のことができます。

管理者アカウントの追加と管理。
説明、スクリーンショットなど、アプリの詳細を追加します。
アプリの公開を停止する。

[限定公開アプリ] ページの使用方法については、managed Google Play ヘルプセンターをご覧ください。

選択ボタン

アプリが公開されたら、IT 管理者はアプリの詳細ページでタイトルと APK を編集できます。アプリの詳細ページには [SELECT] ボタンも表示されます（図 2 を参照）。IT 管理者がこのボタンをクリックしたときに実行されるアクションを指定する必要があります（ステップ 3 の onproductselect をご覧ください）。iframe イベントを処理する）。

ウェブアプリ

[ウェブアプリ] ページでは、IT 管理者がウェブサイトのショートカットを限定公開アプリとして managed Google Play に公開できます。ウェブアプリはパッケージ名（productId）で識別できます。通常、公開には 10 分ほどかかります。公開すると、企業向けに自動的に承認され、他の承認済みアプリと同様にユーザーに配布できるようになります。ウェブアプリは、他の管理対象の Google Play iframe 機能と互換性があります。Google Play 検索ページで検索でき、コレクションに追加できます。

ウェブアプリ作成フォームには、タイトル、HTTPS または HTTP URL、アイコン画像（512 x 512 JPG または 32 ビット PNG）が必要です。また、IT 管理者は次の 3 つの表示オプションから選択できます。

全画面: アプリは全画面モードで開き、デバイスのステータスバーとナビゲーションバーは表示されません。
スタンドアロン（デフォルト）: アプリにデバイスのステータスバーとナビゲーションバーが表示されます。
ミニマル UI: アプリには、デバイスのステータスバーとナビゲーションバー、アプリの URL、更新オプションが表示されます。HTTP URL の場合は、これが唯一の選択肢となります。

[ウェブアプリ] ページでは、IT 管理者がウェブアプリを編集、削除することもできます。ウェブアプリを削除すると、ユーザーの managed Google Play ストアから削除されますが、アプリがすでにデバイスにインストールされている場合は、ユーザーが引き続きアクセスできる場合があります。ユーザーのデバイスからウェブアプリを削除するには、アプリを削除するをご覧ください。ウェブアプリの作成と編集方法については、managed Google Play ヘルプセンターをご覧ください。

選択ボタン

ウェブアプリが公開されると、その詳細ページに [選択] ボタンが表示されます。IT 管理者がこのボタンをクリックしたときに実行されるアクション（アプリの配布など）を指定する必要があります（ステップ 3 の onproductselect を参照）。iframe イベントを処理する）。

アプリの整理

**図 4.** アプリを整理するページが表示された managed Google Play iframe。

[アプリを整理] ページでは、IT 管理者がアプリをコレクション（クラスタ）に整理できます。たとえば、IT 管理者は、よく使用するアプリ用に [必須アプリ] コレクションを作成したり、費用の追跡や出張の記録などに関連するアプリ用に [費用] コレクションを作成したりできます。コレクションは、ユーザーのデバイスの Google Play ストアのホームページに表示されます。

EMM は、iframe URL のパラメータで SELECT mode を使用して、アプリの検索とコレクションへの追加を許可する必要があります。

ユーザーのデバイスでは、Google Play ストアアプリに、ユーザー（またはデバイス）が利用できるコレクションのアプリのみが表示されます。コレクションに、ユーザー（またはデバイス）が利用できるアプリが含まれていない場合、そのコレクションは Google Play ストアに表示されません。

managed Google Play iframe — **図 5.** デバイス上のアプリコレクション（*クラスタ*）
。

IT 管理者は、[アプリを整理] ページで既存のコレクションの編集、削除、コピーも行えます。これらのタスクを実行する方法については、managed Google Play ヘルプセンターをご覧ください。

iframe をコンソールに追加する

ステップ 1. ウェブトークンを生成する

enterprises.webTokens.create を呼び出して、エンタープライズを識別するウェブトークンを生成します。レスポンスには、トークンの value が含まれます。

parentFrameUrl を、iframe をホストする親フレームの URL に設定します。
iframeFeature を使用して、iframe で有効にする機能（PLAY_SEARCH、PRIVATE_APPS、WEB_APPS、STORE_BUILDER）を指定します（アプリを整理）。iframeFeature が設定されていない場合、iframe はデフォルトですべての機能を有効にします。

ステップ 2. iframe をレンダリングする

managed Google Play iframe をレンダリングする方法の例を次に示します。

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

このコードは、コンテナ div 内に iframe を生成します。iframe タグに適用する属性は、前述の「attributes」オプションで設定できます。

URL パラメータ

次の表に、URL パラメータとして URL に追加できる iframe で使用可能なすべてのパラメータを示します。

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',

パラメータ	ページ	必須	説明
`token`	なし	○	ステップ 1 から返されたトークン。
`iframehomepage`	なし	いいえ	iframe がレンダリングされたときに表示される最初のページ。有効な値は `PLAY_SEARCH`、`WEB_APPS`、`PRIVATE_APPS`、`STORE_BUILDER`（アプリを整理）です。指定しない場合、次の優先順位でページが表示されます。`PLAY_SEARCH`、2. `PRIVATE_APPS`、3. `WEB_APPS`、4. `STORE_BUILDER`。
`locale`	なし	いいえ	iframe 内のコンテンツをローカライズするために使用される、適切な形式の BCP 47 言語タグ。指定しない場合、デフォルト値は `en_US` です。
`mode`	アプリを検索	いいえ	`SELECT`: IT 管理者がアプリを選択できます。 `APPROVE`（デフォルト）: IT 管理者がアプリを選択、承認、承認解除できます。非推奨: このモードは非推奨です。代わりに `SELECT` を使用してください。 2025 年 9 月 30 日以降、このメソッドは誰も使用できなくなります。 `APPROVE` モードは、ウェブトークンで `PlaySearch.ApproveApps` が `true` に設定されている場合にのみ機能します。
`showsearchbox`	アプリを検索	いいえ	`TRUE`（デフォルト）: 検索ボックスを表示し、iframe 内から検索クエリを開始します。 `FALSE`:検索ボックスは表示されません。
`search`	アプリを検索	いいえ	検索文字列。指定すると、iframe は指定された文字列を含む検索結果に IT 管理者を誘導します。注: このパラメータは、検索ボックスが iframe の外部にある場合（`showsearchbox = FALSE`）にのみ含めます。

ステップ 3. iframe イベントを処理する

また、統合の一部として次のイベントも処理する必要があります。

イベント説明

イベント	説明
`onproductselect`	ユーザーがアプリを選択または承認します。これにより、次を含むオブジェクトが返されます。 { "packageName": The package name of the app, e.g. "com.google.android.gm", "productId": The product ID of the app, e.g. "app:com.google.android.gm", "action": The type of action performed on the document. Possible values are: "approved", "unapproved" or "selected." If you implement the iframe in `SELECT` mode, the only possible value is "selected". }

onproductselect

ユーザーがアプリを選択または承認します。これにより、次を含むオブジェクトが返されます。

{
    "packageName": The package name of the app, e.g. "com.google.android.gm",
    "productId": The product ID of the app, e.g. "app:com.google.android.gm",
    "action": The type of action performed on the document. Possible values are:
    "approved", "unapproved" or "selected." If you implement the iframe in SELECT
    mode, the only possible value is "selected".
}

次のサンプルは、onproductselect をリッスンする方法を示しています。

iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);

独自のアプリを Google Play ストアにアップロードする

お客様またはお客様のお客様が Android アプリを開発している場合は、Google Play Console を使用して Play ストアにアップロードできます。

アプリを Google Play ストアで一般公開しない場合は、Google Play Console を使用してアプリを単一の企業に制限できます。Google Play Custom App Publishing API を使用して限定公開アプリをプログラマティックに公開することもできます。限定公開アプリは、制限されている企業のみが利用できます。ポリシーを使用してインストールすることはできますが、企業外のユーザーには表示されません。

アプリの配布

アプリをインストールする

クローズド テスト用にアプリを配布する

クローズド テストの対象となるアプリ

クローズド テストに企業を追加する

クローズド トラックをユーザーに配布する

managed Google Play iframe

機能

アプリを検索

検索ボックス

限定公開アプリ

選択ボタン

ウェブアプリ

選択ボタン

アプリの整理

iframe をコンソールに追加する

ステップ 1. ウェブトークンを生成する

ステップ 2. iframe をレンダリングする

URL パラメータ

ステップ 3. iframe イベントを処理する

独自のアプリを Google Play ストアにアップロードする

クローズドテスト用にアプリを配布する

クローズドテストの対象となるアプリ

クローズドテストに企業を追加する

クローズドトラックをユーザーに配布する