Guides

サービスアカウントを設定する

Suggest Edits

KARTE のプッシュ通知では、バックエンドに Firebase Cloud Messaging (以下FCM) を使用しています。

🚧

複数のFirebaseプロジェクトの利用に関して

KARTEの管理画面では一つのFirebaseプロジェクトの情報しか登録することができません。
複数のFirebaseプロジェクトの情報を紐付けることはできませんのであらかじめご了承ください。

KARTE から FCM にリクエストを送信できるようにするために、KARTE の管理画面上からサービスアカウントの設定を行います。

KARTE の管理画面のグローバルメニュー[すべてのプロダクト] > [ストア] > [アプリ設定] > [KARTE for App] を開き、下記に沿って設定してください。

  1. ネイティブアプリにおける接客表示制御のデフォルト値
  2. FCM API
  3. FirebaseプロジェクトID（またはFCM サーバーキー）
  4. Firebaseサービスアカウント秘密鍵

1. ネイティブアプリにおける接客表示制御のデフォルト値の設定

接客表示前後に画面境界を認識した際の接客表示を制御するオプションです。

表示を制御する場合はチェックを入れてください。詳細は ネイティブアプリにおける接客表示制御とは をご参照ください。

2. FCM API の設定

FCM HTTP v1 API を選択します。

📘

事前に API の有効化が必要です

FCM HTTP v1 API を利用する場合、事前に Firebase Cloud Messaging API を有効化する必要があります。

有効化は Google Developer Console で行います。
https://console.developers.google.com/apis/api/fcm.googleapis.com/overview

KARTEではvFCM HTTP v1 APIによる送信をサポートしています。

FCM HTTP v1 API 利用の場合は、FirebaseプロジェクトIDを設定します

  • Firebase コンソール画面の[プロジェクトの設定] > [全般] で プロジェクトID を確認します。

  • KARTE管理画面の「FirebaseプロジェクトID」に、上記で取得した プロジェクトID を設定します。

4. Firebaseサービスアカウント秘密鍵の設定

Firebaseサービスアカウントの作成

  1. Google Cloud で、該当のプロジェクトを選択後に、[サービスアカウント] ページで [サービスアカウントを作成] を選択

  2. サービスアカウント名、ID、説明を任意の内容で入力して、[作成して続行] を選択

  3. [ロールを選択] フィールドで、ロールのリストから [Firebase Cloud Messaging API 管理者] を選択して、[完了] を選択

    1. アクセスをより制限する場合は、cloudmessaging.messages.create 権限を持つカスタムロールを作成して、それをリストから選択

    2. 作成したサービスアカウントの権限を確認するには、該当のプロジェクトを選択後に、[IAM] を選択

Firebaseサービスアカウント秘密鍵の生成

  1. Google Cloud で、該当のプロジェクトを選択後に、[サービスアカウント] ページで、上記で作成したサービスアカウントの [：] > [鍵を管理] を選択

  2. [キーを追加] > [新しい鍵を作成] を選択

  3. [JSON] を選択して、[作成] を選択

Firebaseサービスアカウント秘密鍵のアップロード

KARTE管理画面上の [Firebaseサービスアカウント秘密鍵] に、上記で生成した秘密鍵をアップロード

完了したら、 保存 ボタンをクリックして設定は完了です。

Updated 28 days ago