> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Firebase を連携する

> Firebase プロジェクトの作成、FCM の設定、APNs 認証キーの登録など、Notifly でプッシュ通知を配信するための設定手順を説明します。

Notifly は、プッシュ通知とアプリ内ポップアップの配信に [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging) を使用します。

* Firebase Cloud Messaging を使用するには、Firebase プロジェクトが必要です。
* このガイドでは、Firebase プロジェクトを作成し、Notifly と連携する手順を説明します。

## 1. 事前準備

### 1-1. Firebase プロジェクトを設定する

Firebase プロジェクトを作成し、そのプロジェクトにアプリを登録してください。

* [Firebase プロジェクトの作成](https://firebase.google.com/docs/projects/learn-more?hl=ja)を参照してください。
* [Firebase プロジェクトへのアプリの追加](https://firebase.google.com/docs/projects/learn-more?hl=ja#setting_up_a_firebase_project_and_registering_apps)を参照してください。

### 1-2. プラットフォームごとに Firebase を設定する

> [tab] Flutter
>
> Flutter では、次のいずれかの方法で Firebase を設定できます。
>
> 1. **FlutterFire CLI を使ってインストールと初期化を行う（推奨）**\
>    [FlutterFire の設定ガイド](https://firebase.google.com/docs/flutter/setup?hl=ja#configure-firebase)を参照してください。
> 2. **iOS と Android で、インストールと初期化を手動で行う**\
>    以下の**Android**タブと**iOS**タブの手順に従ってください。
>
> どちらの方法でも、設定後に次のファイルがプロジェクトに含まれていることを確認してください。
>
> * **Android:** `google-services.json`
> * **iOS:** `GoogleService-Info.plist`

> [tab] React Native
>
> React Native では、Android と iOS のそれぞれで Firebase の設定が必要です。**Android** タブと **iOS** タブの手順に従ってください。
>
> > Firebase コンソールで Android アプリと iOS アプリの両方を登録してください。

> [tab] Android
>
> Firebase プロジェクトに登録したアプリの `google-services.json` を、Android プロジェクトに追加してください。
>
> * [Android への Firebase 設定ファイルの追加](https://firebase.google.com/docs/android/setup?hl=ja#add-config-file)を参照してください。
>
> > `google-services.json` は `app/` ディレクトリに配置してください。

> [tab] iOS
>
> Firebase プロジェクトに登録したアプリの `GoogleService-Info.plist` を、iOS プロジェクトに追加してください。
>
> * [iOS への Firebase 設定ファイルの追加](https://firebase.google.com/docs/ios/setup?hl=ja#add-config-file)を参照してください。
>
> > Xcode プロジェクトのルートに `GoogleService-Info.plist` を追加し、ビルドターゲットに含まれていることを確認してください。

***

### 1-3. APNs 認証キーを登録する

iOS アプリでは、React Native や Flutter の場合も、Firebase プロジェクトに **APNs 認証キー**をアップロードしてください。

* [APNs 認証キーのアップロード](https://firebase.google.com/docs/cloud-messaging/ios/get-started?hl=ja#upload-apn-authentication-key)を参照してください。

iOS デバイスにプッシュ通知を送信するには、APNs 認証キーが必要です。

## 2. Firebase Cloud Messaging API (V1) を有効にする

Notifly からデバイスにプッシュ通知とアプリ内ポップアップを配信するには、Firebase Cloud Messaging API (V1) を有効にする必要があります。

1. [Firebase コンソール](https://console.firebase.google.com/)にログインします。
2. 左側のメニューから **設定 > 全般**を開きます。

![Firebase プロジェクトの設定を開く](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-go-to-settings.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=e83635756cd9e822b78796a0d366e69d)

3. **Cloud Messaging**（クラウド メッセージング）タブを開きます。
4. **Firebase Cloud Messaging API (V1)** が有効になっているか確認します。
   * すでに有効な場合は、セクション 3 に進み、FCM サービスアカウントを Notifly に登録してください。
5. 無効な場合は、API の欄の右上にあるアイコンをクリックし、管理ページを開きます。

![有効な Firebase Cloud Messaging API とそのメニュー](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-enable-api.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=3baff757dcdacf47dfdbdb04ccf01197)

6. Google Cloud コンソールで Firebase Cloud Messaging API を有効にします。

![Firebase Cloud Messaging API を有効にする](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-click-enable.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=348d6b5661375e887a1aea3b66aff0aa)

## 3. FCM サービスアカウントを Notifly に登録する

Notifly と Firebase Cloud Messaging (FCM) を連携するには、メッセージの送信権限を持つサービスアカウントの JSON キーが必要です。
権限とキーを個別に管理できるように、**Notifly 専用のサービスアカウント**を作成してください。

### FCM サービスアカウントのキーを作成する

1. [Google Cloud コンソールのサービスアカウントページ](https://console.cloud.google.com/iam-admin/serviceaccounts)を開きます。Firebase コンソールとは別の画面です。上部のプロジェクト選択で、**アプリが使用する Firebase プロジェクトと同じプロジェクト**を選びます。表示名が異なる場合は、Firebase のプロジェクト設定にある**プロジェクト ID**を照合してください。
2. **IAM & Admin → Service Accounts**（IAM と管理 → サービス アカウント）で、**Create service account**（サービス アカウントを作成）をクリックします。

![サービスアカウントのメニューと作成ボタン](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-open-service-accounts.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=13a258c6d587a892f80515c7194d99b4)

3. サービスアカウントの名前と ID を入力し、**Create and continue**（作成して続行）をクリックします。たとえば、名前を `Notifly`、ID を `notifly-fcm-sender` にします。
4. **Permissions**（権限）のステップで、ロールの選択欄から **Firebase Cloud Messaging API Admin** を検索して選びます。

![Firebase Cloud Messaging API Admin ロールの選択画面（英語）](https://mintcdn.com/notifly/WGuMIjE1pRKnkV4B/ko/developer-guide/image/fcm_v1_guide_select_fcm_role.png?fit=max\&auto=format\&n=WGuMIjE1pRKnkV4B\&q=85\&s=6d3ab2fd359767d5f61e938d3dd01871)

5. **Continue**（続行）をクリックします。次の **Principals with access**（アクセス権を持つプリンシパル）は空欄のまま、**Done**（完了）をクリックします。
6. サービスアカウント一覧で、**作成した専用アカウント**の右側のメニュー（⋮）を開き、**Manage keys**（鍵を管理）を選びます。

![専用サービスアカウントの鍵の管理メニュー](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-manage-keys.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=8f0bf47153105e72b5a89d0d4df33120)

7. **Keys**（鍵）タブで、**キーを追加 → 新しい鍵を作成**を選びます。

![鍵を追加メニューから新しい鍵を作成する](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-add-key.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=b4885465f9752282efa13984b6435f20)

8. キーのタイプに **JSON** を選び、**Create**（作成）をクリックします。

![JSON 形式のサービスアカウントキーを作成する](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-create-service-account-key.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=809a4a6e2fc23a29ab170fa514e30231)

9. ダウンロードした JSON キーファイルを安全な場所に保管します。秘密鍵が含まれているため、公開リポジトリやアプリのコードには含めないでください。

### Notifly コンソールにキーを登録する

1. Notifly コンソールで、連携先のプロジェクトと**開発環境または本番環境**を確認します。次に**設定 → チャネル設定**を開き、「**プッシュ通知 (App)**」セクションに移動します。
2. 新規登録する場合は**登録**をクリックします。登録済みのアカウントを更新する場合は、入力欄の横にある鉛筆アイコンをクリックします。設定に応じて、以下の入力欄にダウンロードしたJSONファイルの内容を貼り付けて保存します。
   * 共通のアカウントを使う場合は、**FCMサービスアカウント**に入力します。
   * AndroidとiOSで別々のアカウントを使う場合は、**Android FCMサービスアカウント**と**iOS FCMサービスアカウント**に入力します。新規登録時は**プラットフォーム別サービスアカウントの登録**をオンにすると、両方の入力欄が表示されます。

![Notifly コンソールの FCM サービスアカウント設定](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/fcm/fcm-v1-guide-notifly-setting.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=120e71cc9cd4d69ebe3ee9596abac93e)

3. 連携したプラットフォームのテスト端末にプッシュ通知を送り、実際に受信できることを確認します。キーの保存に成功しても、送信権限と端末への配信が確認できたことにはなりません。

> [!NOTE]
>
> 既存のキーを置き換える場合は、開発環境で検証してから本番環境に適用してください。
> 問題が発生した場合に復元できるよう、既存の設定は安全に保管します。古いアカウントやキーを削除する前に、
> 他のサービスが使用していないことと、切り替えが完了していることを確認してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.