---
title: "Androidプッシュ通知"
url: https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/android/
description: "Catalystは、iOS、Android、およびWebアプリにすぐに実装できるプッシュ通知サービスを提供し、送信前に通知をテストすることも可能です。"
last_updated: 2026-08-17T12:16:04Z
service: Cloud Scale
type: general
---

# Androidプッシュ通知

### はじめに

Catalystは、[Firebase Cloud Messaging (FCM)](https://firebase.google.com/docs/cloud-messaging)を使用して、CatalystアプリのプッシュメッセージをクライアントAndroidデバイスに転送します。FCMは[Google Firebase](https://firebase.google.com/)によるクロスプラットフォームメッセージングソリューションで、プッシュ通知をクライアントデバイスに配信するためのバックエンドとトランスポートレイヤーを提供します。Catalystはこのシナリオにおいてアプリサーバーとして機能し、アプリのロジックを実行してプッシュ通知リクエストを処理します。以下のセクションでこのプロセスを詳しく説明します。

プッシュ通知フローの一般的なアーキテクチャについては、[アーキテクチャヘルプセクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/architecture/)で学ぶことができます。

### 主要概念

#### 実装パスとワークフロー

AndroidアプリのCatalystプッシュ通知を設定するための実装パスは以下の通りです：

* FirebaseにアプリをregistrationしFirebaseの設定ファイルをアプリのディレクトリに追加することで、AndroidアプリでFirebaseサービスを有効にします。
* プライベートキーを生成してFirebase Admin SDKへのアクセスを取得します。
* Firebase Admin SDKのプライベートキーをCatalystに追加して、Catalystでプッシュ通知に登録します。
* プッシュ通知を受信するモバイルデバイスを登録します。

上記の実装を行った後、アプリからプッシュ通知が送信される際にバックグラウンドで以下のプロセスが実行されます：

* Catalystは[Firebase Admin SDK](https://firebase.google.com/docs/cloud-messaging/server#firebase-admin-sdk-for-fcm)を通じてFCMのバックエンドと通信します。これはFCMサーバーと通信するための優れた、強く推奨されるオプションです。
* Catalystはビジネスロジックから、またはテスト通知の場合はCatalystコンソールからプッシュ通知メッセージをFCMのバックエンドに転送します。
* その後、Firebaseは設定されたサーバーロジックに基づいて、プッシュ通知メッセージをユーザーのデバイスで実行されているクライアントアプリにルーティングします。

#### Androidプッシュ通知の要素
	
Androidは、基本的なテキスト通知、リッチメディア要素を含む通知、通話スタイルの通知など、多数の通知タイプをサポートしています。FCMはクライアントへのメッセージを2つのタイプに分類しています。[ヘルプドキュメント](https://firebase.google.com/docs/cloud-messaging/concept-options)で説明されているように、通知メッセージとデータメッセージです。ヘルプページに記載されている形式と仕様に従って、いずれかのタイプで通知を作成できます。

画像、ハイパーリンク、コールトゥアクションボタンなどの要素は、これらのメッセージ形式のデータペイロードとして渡すことができます。CatalystはAndroidプッシュ通知での通知バッジカウントもサポートしています。これにより、通知バッジに未読の通知数が表示されます。

プッシュメッセージの作成と送信時には、AndroidとFCMが定義する基準、ガイドライン、および制限に従う必要があります。詳細については、通知の[デザイン](https://developer.android.com/design/ui/mobile/guides/home-screen/notifications)と[開発](https://developer.android.com/develop/ui/views/notifications)に関するAndroidの公式ドキュメントを参照してください。

### Androidプッシュ通知の設定と登録

AndroidアプリのCatalyst Push Notificationサービスの設定と登録手順を、論理的な順序で以下に示します：

#### ステップ1：FirebaseのAndroid設定ファイルを生成する

まず、AndroidアプリでFirebaseを有効にする必要があります。以下の手順で、Firebase上にAndroidアプリのプロジェクトを作成し、Android SDKと設定ファイルを追加します：

1. AndroidアプリのFirebaseプロジェクトをまだ作成していない場合は、[Firebaseコンソール](https://console.firebase.google.com/u/0/)にログインして作成できます。新しいFirebaseプロジェクトを作成するオプションを選択します。

![catalyst_push_notifications_android_firebase_configuration](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_googleserv_1.webp)

すでにAndroidアプリのFirebaseプロジェクトを作成している場合は、ステップ4に進んでください。

2. Firebaseプロジェクトの名前を入力し、チェックボックスにチェックを入れます。**Continue**をクリックします。

![catalyst_push_notifications_android_firebase_configuration](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_googleserv_2.webp)

3. 必要に応じて、プロジェクトのGoogle Analyticsを有効にして設定できます。**Continue**をクリックします。

![catalyst_push_notifications_android_firebase_configuration](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_googleserv_3.webp)

プロジェクトが作成されます。

4. プロジェクトが作成された後、Androidアイコンをクリックして、アプリのFirebase Android SDKを設定できます。

![catalyst_push_notifications_android_firebase_configuration](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_googleserv_4.webp)

5. Androidアプリのパッケージ名と表示名を入力し、**Register App**をクリックします。アプリのデバッグ署名証明書を生成済みの場合は、オプションで設定することもできます。

![catalyst_push_notifications_android_firebase_configuration](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_googleserv_5.webp)

> **注意:** Catalystで[Androidアプリを登録](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/developer-tools/#android-and-ios-sdks)する際、およびアプリのプッシュ通知を設定する際に、*App Bundle ID*と同じパッケージ名を指定する必要があります。

6. ダウンロードボタンをクリックして、Firebaseが生成した`google-services.json`ファイルをダウンロードできます。**Next**をクリックして、アプリにFirebase SDKを組み込むためのコードスニペットを確認し、セットアップを完了します。

![catalyst_push_notifications_android_firebase_configuration](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_googleserv_6.webp)

7. ダウンロードした`google-services.json`設定ファイルは、上記のようにAndroid Studioを通じてアプリのモジュール（アプリレベル）ルートディレクトリに追加する必要があります。

これでFirebaseのAndroid設定ファイルがAndroidアプリで利用可能になりました。

#### ステップ2：Firebaseアクセス用のプライベートキーを生成する

次のステップは、AndroidアプリケーションからFirebase Admin SDKにアクセスするためのプライベートキーを生成することです。[Firebase Admin SDK](https://firebase.google.com/docs/cloud-messaging/server#firebase-admin-sdk-for-fcm)の統合Admin SDKは、複数のFirebase機能の認証を容易にし、FCMを通じたメッセージの送信やトピックサブスクリプションの管理に対する完全な管理者権限を提供します。これは、Firebaseが管理者権限でサービスを運用および管理するために使用する[Firebaseサービスアカウント](https://firebase.google.com/support/guides/service-accounts)の一部として利用できます。

以下の手順に従って、サービスアカウントのプライベートキーを生成できます。

1. [Firebaseコンソール](https://console.firebase.google.com/u/0/)に移動します。以前にAndroidアプリケーションを設定したプロジェクトを開きます。

![catalyst_push_notifications_android_private_key](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_privkey_1.webp)

2. コンソールで**Project Overview**をクリックし、**Project settings**をクリックします。

![catalyst_push_notifications_android_private_key](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_privkey_2.webp)

3. プロジェクト設定の**Service Accounts**タブに移動します。*Firebase Admin SDK*セクションから、**Generate new private key**をクリックします。

![catalyst_push_notifications_android_private_key](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_privkey_3.webp)

4. 表示されるポップアップから**Generate key**をクリックします。

![catalyst_push_notifications_android_private_key](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_privkey_4.webp)

これにより、プライベートキーJSONファイルがシステムにダウンロードされます。

#### ステップ3：CatalystでAndroidプッシュ通知サービスを設定する

FirebaseからAndroidアプリのサービスアカウントプライベートキーを取得した後、アプリでCatalyst Push Notificationサービスに登録するために、そのキーをCatalystに設定する必要があります。

CatalystでAndroidアプリのプッシュ通知に登録するには：

1. プロジェクトのCatalystコンソールから**Cloud Scale**サービスに移動し、**Push Notifications**を開きます。**Android**タブをクリックし、**Configure**をクリックします。

![catalyst_push_notifications_android_configure](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_1.webp)

2. AndroidアプリのバンドルIDを入力します。これは、[Firebaseでアプリを登録](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/android/#step-1-generate-firebases-android-configuration-file)した際、および[Catalystでアプリを登録](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/developer-tools/#android-and-ios-sdks)した際に指定したパッケージ名と同じである必要があります。次に、[前のセクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/android/#step-2-generate-private-key-for-firebase-access)でFirebase Admin SDK用に生成したサービスアカウントJSONファイル（プライベートキーファイル）をアップロードします。

![catalyst_push_notifications_android_configure](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_2.webp)

3. **Enroll**をクリックします。

これにより、Catalyst Androidプッシュ通知サービスに登録されます。Firebaseサービスアカウントの JSONファイルが設定されると、CatalystはAndroidアプリのFCMサーバーと通信できるようになります。

その後、Androidアプリの登録済みユーザーにプッシュ通知を送信したり、コンソールから通知の送信をテストしたりできます。

#### ステップ4：プッシュ通知用のモバイルデバイスを登録する

Androidアプリからプッシュ通知を送信したり、Catalystコンソールから送信をテストしたりする前に、プッシュ通知を受信するモバイルデバイスを登録する必要があります。

これは、デバイスから以下のコードスニペットを呼び出すことで実行できます。これにより、必要な資格情報がCatalyst SDKの`app.registerNotification()`メソッドに渡されます。

```javascript
val app = ZCatalystApp.getInstance()
app.registerNotification(device_token,"bundleID",
                 "appID", test_device_boolean, {
                    Log.i("Register","App register successfully");
                }, {
                    Log.i("Register","App register failed");
                })
```

**パラメータ：**
    
* `device_token`：アプリの[FCM](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/android/#step-1-generate-firebases-android-configuration-file)から取得したデバイストークン。

* `bundleID`：Catalystおよび Firebaseで[アプリを登録](https://docs.catalyst.zoho.com/ja/sdk/android/v2/setup/)した際に設定したAndroidアプリのバンドルID。

* `appID`：Push NotificationsでCatalystがアプリに対して生成したアプリID。CatalystコンソールのPush Notificationsの*Android*セクションで確認できます。

* `test_device_boolean`：テストデバイスの場合は`true`に、本番デバイスの場合は`false`に設定します。

モバイルデバイスが登録された後、ユーザーはデバイスからプッシュ通知を送信するためのアプリの明示的な許可を提供する必要があります。許可プロンプトを送信してユーザーが許可または拒否できるようにすることで、アプリのロジックでこれを処理できます。許可が提供された後、デバイスにテスト通知を送信できます。

> **注意:** エンドユーザーはプッシュ通知を受信するためにAndroidアプリで認証されている必要があります。[Catalyst Authentication](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/introduction/)を通じてアプリでユーザー認証を処理できます。

**モバイルデバイスの登録解除**

以下のコードを実行することで、Androidアプリからのプッシュ通知の受信からモバイルデバイスの登録を解除できます。これにより、必要な資格情報がCatalyst SDKの`app.deregisterNotification()`メソッドに渡されます。

```javascript
val app = ZCatalystApp.getInstance()
app.deregisterNotification (device_token,"bundleID",
 "appID", test_device_boolean, {
                Log.i("Unregister","App unregistered successfully");

            }, {
                Log.i("Unregister","App unregisteration failed");
            })
```

**パラメータ：**
    
* `device_token`：アプリの[FCM](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/android/#step-1-generate-firebases-android-configuration-file)から取得したデバイストークン。

* `bundleID`：CatalystおよびFirebaseで[アプリを登録](https://docs.catalyst.zoho.com/ja/sdk/android/v2/setup/)した際に設定したAndroidアプリのバンドルID。

* `appID`：Push NotificationsでCatalystがアプリに対して生成したアプリID。CatalystコンソールのPush Notificationsの*Android*セクションで確認できます。

* `test_device_boolean`：テストデバイスの場合は`true`に、本番デバイスの場合は`false`に設定します。

### Androidプッシュ通知のテスト

Catalystでは、コンソールから登録済みのすべてのユーザーデバイスにテキスト形式のテスト通知を送信できます。コンソールから必要なオプションを選択して、開発環境または本番環境の[環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)からテスト通知を送信できます。テスト通知の送信先のエンドユーザーがアプリで認証済みであり、登録ユーザーであることを確認してください。

> **注意:** Androidアプリのエンドユーザーは、プッシュ通知を受信するためにアプリで認証されている必要があります。ユーザー認証には、[Catalyst Android SDK](https://docs.catalyst.zoho.com/ja/sdk/android/v2/overview/)から[Catalyst Authentication](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/introduction/)をアプリに実装できます。

CatalystコンソールからCatalyst Androidアプリのテストプッシュ通知を送信するには：

1. プロジェクトのCloud Scaleセクションから**Push Notifications**に移動します。Androidタブをクリックします。

![catalyst_push_notifications_android_test](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_3.webp)

2. プッシュ通知のメッセージを入力し、**Send**をクリックします。

![catalyst_push_notifications_android_test](https://catalyst-docs-development.zohostratus.in/images/help/notifications/cayalyst_push_notifications_android_4.webp)

メッセージは、Androidアプリで登録され認証されたユーザーデバイスにプッシュ通知として送信されます。