EMM プッシュ通知を有効にする

このガイドでは、すでに手動で作成された ESA があることを前提としています。 EMM プッシュ通知と併用するための設定方法を説明します。タスクが完了しました (お客様、EMM ソリューション プロバイダ、またはお客様の)によって、 Google API Console:

1. Google API Console で Google Cloud Pub/Sub API アクセスを プロジェクトです。

2. ESA に編集者権限を付与します。

3. EMM 通知を受け取るようにプロジェクトを設定します。

4. テスト用の EMM 通知を送信します。

5. トピックを登録します。

手順については、以降のセクションで詳しく説明します。

1. プロジェクトの Cloud Pub/Sub API アクセスを有効にする

プロジェクトで Cloud Pub/Sub API を有効にするには:

  1. API Console で [API ライブラリ] を開きます。選択 プロジェクトに追加します(必要に応じて新しいプロジェクトを作成します)。API ライブラリには、 プロダクト ファミリーと人気度でグループ化されています。
  2. [Google Cloud APIs] で [Cloud Pub/Sub API] を探します。( 含まれている場合は、検索を使用して見つけてください)。
  3. [Cloud Pub/Sub API] を選択し、[有効にする] をクリックします。

API を有効にしたら、[API とサービス メニューで、 ダッシュボード: 有効な API のリストを表示します。クラウド導入前 Pub/Sub API を使用して顧客へのメッセージを伝えるには、編集者に権限を付与する必要があります。 そのお客様のサービス アカウント(ESA)に付与する必要があります。

2. ESA に編集者権限を付与する

API Console から、必要な権限を付与します。

  1. [API と[サービス] メニューで [認証情報] をクリックします。すべきこと お客様の ESA が [サービス アカウント キー] に表示されていることをご確認ください。
  2. [サービス アカウントを管理] をクリックして、すべてのサービス アカウントを開きます。 関連付けられます。
  3. リストから適切な ESA アカウントを選択し、[ 権限
  4. [メンバーを追加] フィールドで次の操作を行います。 <ph type="x-smartling-placeholder">
      </ph>
    • ESA に関連付けられているメールアドレスを入力します。
    • プルダウン メニューから [エディタ]( 表示されます。
  5. [Add] をクリックして権限を保存します。

3. EMM 通知を受け取るようにプロジェクトを設定する

Cloud Pub/Sub API が有効で、エディタで ESA が構成されている EMM 通知を受信するようにプロジェクトを設定できます。 Set EMM プッシュ通知を設定する簡単に言うと、設定プロセスには、 HTTP サーバーエンドポイントを使用して サブスクライバーに通知をプッシュします

EMM 通知は protobufs (構造化データをシリアル化するためのシンプルな形式、プロトコル バッファ)としてパックされ、 JSON パケット内の byte64 でエンコードされたバイト配列メッセージ。コードでは、 この JSON を解析し、プロトコル バッファの内容をデコードします。こちらをご覧ください NewPermissionsEvent 用に Base64 で URL セーフにエンコードされた protobuf 通知:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

次のようにデコードされます。


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

protobuf 形式の EMM 通知をデコードするには、 emm_pubsub.proto ファイルの場所: <ph type="x-smartling-placeholder"></ph> GitHub の google/play-work リポジトリ新しい通知タイプが 追加されると、そのファイルが新しいタイプで拡張され、サンプルコードが更新されます。 これらの変更には下位互換性があるはずですが、コード内で 各種の通知に加えて不明なタイプの通知も 列挙値を示しています。

4. テスト用の EMM 通知を送信する

テスト通知を送信すると、正常に完了したことを確認できます Google Play から EMM 通知を受け取るようにシステムを設定する トピック名も確認できます(同じトピック名を使用して Google Play のすべての EMM 通知など)に適用されます。

Play EMM API を使用して、Enterprises リソースの sendTestPushNotification メソッドを呼び出します。

このオペレーションを呼び出すと、テスト用の EMM 通知が送信されます。EMM の場合 設定されている場合、API は以下を返します。

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

5. トピックにサブスクライブする

パブリッシャー テストコード([EMM プッシュの設定 通知ガイドを参照)、指定したトピックにサブスクライブします。通知を受け取ります。 テスト EMM 通知のほか、実際に配信されていた 継続的に生成されています。