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 つの異なる通知メカニズムをサポートしています。ただし、プル通知のみをおすすめします。プル アプローチでは、外部サーバーの設定は必要ありません。プログラムで作成された ESA と手動で作成された ESA の両方で機能します。プル通知のもう 1 つの利点は、お客様による追加の構成やメンテナンスがほとんど必要ないことです。Enterprises.pullNotificationSet
と Enterprises.acknowledgeNotificationSet
を使用して、長時間実行される送信接続を介して EMM 通知を受信して確認します。
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(Installs など)と、Devices リソースを返す API を呼び出せるようになりました。この通知は、管理対象デバイスに最初のアカウントがプロビジョニングされた後にのみ送信されます。非推奨 | NewDeviceEvent |
管理者は、managed Google Play Console でアプリを承認済みまたは未承認としてマークします。非推奨 | ProductApprovalEvent
|
デバイスへのインストールが保留中のままタイムアウトします。たとえば、プッシュ インストール リクエストは承認されたものの、デバイスに数日間アクセスできないため、インストールを確認できない場合です。システムからインストール タイムアウトの通知が送信されます。 | InstallFailureEvent
|
アプリの新しいバージョンが公開されます。アップデートは 1 台以上のデバイスで利用できます(すべてのデバイスで利用できるとは限りません)。非推奨 | AppUpdateEvent
|
アプリの更新では、更新または新規インストールを実行できるように、新しい権限を管理者が承認する必要があります。この通知は、アプリが承認した権限セットが、アプリがリクエストした権限セットと異なる場合に送信されます。非推奨 | NewPermissionsEvent |
新しいバージョンまたは変更されたマネージド構成スキーマを含むアプリの新しいバージョンが公開されます。デベロッパーが新しい APK をアップロードすると、Google Play はマニフェスト内のスキーマを以前のバージョンのアプリのスキーマと比較します。スキーマが変更されている場合は、アプリを承認した企業に通知します。非推奨 | AppRestrictionsSchemaChangeEvent |
利用可能なアプリが利用できなくなったり、利用できないアプリが Google Play に再び追加されたりする。デベロッパーがアプリの公開を停止した場合、またはアプリが Google Play から削除された場合、アプリの公開状況は変わります。公開されていないアプリが Google Play に再び追加された場合も、公開状況は変更されます。非推奨 | ProductAvailabilityChangeEvent |
エンタープライズ アップグレードに関する通知。エンタープライズ アップグレードとは、managed Google Play アカウント エンタープライズを Managed Google Domains にアップグレードするプロセスです。 | EnterpriseUpgradeEvent |