EMM 通知を設定する

Google Play は、企業に影響を与えるさまざまなイベントに応答して、EMM 通知という通知を生成します。たとえば、アプリが承認されると、ProductApprovalEvent 通知が送信されます。

EMM 通知は、特定のエンタープライズ サービス アカウント（ESA）に関連付けられます。EMM として、受信した通知に基づいて企業の IT 管理者にアラートやメッセージを表示するようにコンソールを設定できます。

EMM 通知は Google Cloud Pub/Sub を使用して送信されます。Pub/Sub 通知の設定方法について詳しくは、サブスクライバーの概要と pull サブスクライバー ガイドをご覧ください。

Google Play から EMM 通知を受信し、サブスクリプションを接続する Cloud Pub/Sub トピックの名前を取得するようにシステムが正常にセットアップされたことを確認するには、Enterprises.sendTestPushNotification を呼び出します。

テスト通知を送信すると、企業向け Google Cloud Pub/Sub サービスと EMM の統合が検証されます。EMM 通知が正しく構成されている場合、API は次のものを返します。

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

pull 通知

Google Cloud Pub/Sub は、pull と push という 2 種類の通知メカニズムをサポートしています。ただし、pull 通知のみをおすすめします。pull アプローチは外部サーバーのセットアップを必要とせず、プログラムと手動で作成された ESA の両方で機能します。pull 通知のもう一つの利点は、ユーザーが追加の設定やメンテナンスをほとんど必要としないことです。長時間の送信接続で EMM 通知を受信して確認する場合は、Enterprises.pullNotificationSet と Enterprises.acknowledgeNotificationSet を使用します。

Enterprises.pullNotificationSet を呼び出すときは、requestMode をデフォルト値（waitForNotifications）のままにすることをおすすめします。これにより、リクエストは 1 つ以上の通知が存在するまで待機してからレスポンスを返します。しばらく待っても通知が存在しない場合、リクエストは空の通知リストを返し、その後でリクエストを再試行できます。

通知を受け取ったら、Enterprises.acknowledgeNotificationSet を呼び出して、次回 Enterprises.pullNotificationSet を呼び出したときに同じ通知が返されないようにします。

また、Enterprises.pullNotificationSet を呼び出すときに requestMode を returnImmediately に設定することもできます。リクエストに対するレスポンスがすぐに返されます。レスポンスには保留中の通知が含まれます。通知が存在しない場合は空のリストが含まれます。この requestMode オプションは、通知の実装を最初にテストするときに役立つことがあります。

EMM 通知の例

イベントと、イベントによって生成される通知タイプの例を次に示します。

注: 通知タイプの ProductApprovalEvent、AppUpdateEvent、NewPermissionsEvent、AppRestrictionsSchemaChangeEvent、ProductAvailabilityChangeEvent、NewDeviceEvent は非推奨になりました。AppUpdateEvent には、推奨事項に従って 優先度の高い更新モード を使用する必要があります。

説明通知
テスト通知は、 Google Play EMM API を介してリクエストされます。テスト通知を送信して、Google Play が公開する通知をシステムが受信できることを確認し、Google Play に関連付けられたすべての通知に使用されるトピック名を把握する必要があります。TestPushNotification
新しくプロビジョニングされたデバイスは、Google Play EMM API で管理できるようになります。デバイスの deviceId（インストールなど）を必要とする API と、デバイス リソースを返す API を呼び出せるようになりました。この通知は、管理対象デバイスに最初のアカウントがプロビジョニングされた後にのみ送信されます。 非推奨NewDeviceEvent
管理者が managed Google Play Console で、アプリを承認済みまたは未承認としてマークします。非推奨ProductApprovalEvent
デバイスに対する保留中のインストールがタイムアウトする。たとえば、プッシュ インストール リクエストが承認されたものの、デバイスに数日間アクセスできず、インストールを確認できない場合です。インストール タイムアウト通知が送信されます。InstallFailureEvent
アプリの新しいバージョンが公開されている。アップデートは 1 つ以上のデバイスで利用できますが、必ずしもすべてのデバイスで利用できるわけではありません。非推奨AppUpdateEvent
アプリのアップデートまたは新規インストールを行うために、アプリのアップデートでは管理者による新しい権限の承認が必要になります。この通知は、アプリで指定された権限セットと、リクエストされた権限セットが異なる場合に送信されます。非推奨NewPermissionsEvent
新規または変更された管理対象構成スキーマを含むアプリの新しいバージョンが公開されている。デベロッパーが新しい APK をアップロードすると、Google Play はマニフェストのスキーマをアプリの以前のバージョンのスキーマと比較します。スキーマが変更されると、アプリを承認した企業に通知されます。非推奨 AppRestrictionsSchemaChangeEvent
利用可能なアプリが利用できなくなった場合、または利用できないアプリが Google Play に再度追加された。デベロッパーがアプリの公開を停止したり、Google Play から削除したりすると、アプリの提供状況は変わります。利用できないアプリが Google Play に再び追加された場合も、提供状況は変わります。非推奨 ProductAvailabilityChangeEvent