メインコンテンツへスキップ
日本語版はAIによる翻訳です。正確な情報については英語版をご参照ください。

  1. サービスアカウントの設定

Auxiaは、プッシュ通知API呼び出しの認証にGCPサービスアカウントを使用します。 次の手順に従ってください。
  1. 既存のGoogle CloudプロジェクトでFirebaseの使用を開始します。
  2. リンクされたGCPプロジェクトでサービスアカウントを作成します。
  3. サービスアカウントに以下のロールを割り当てます。 Firebase Cloud Messaging API Admin Firebase cloud messaging
  4. このサービスアカウントのJSONキーを生成します。 JSON key
このサービスアカウントのJSONキーをAuxiaチームと共有してください。

2. FCMトークン

FCMトークンは、Firebase Cloud Messaging(FCM)に登録されたデバイスの一意の識別子です。デバイスにプッシュ通知を送信するには、このトークンが必要です。 ライフサイクル
  • getToken() を使用してトークンを生成します。
  • トークンのリフレッシュイベントを監視します。
アプリケーションがバックエンドでuser_idとFCMトークンの対応付けを更新するようにしてください。これにより、プッシュ通知が正しいユーザーに配信されます。
実装例については、Flutterサンプルセットアップセクションをご参照ください。
user_idとFCMトークンの対応付けは、ユーザー属性のデータ取り込みを通じてAuxiaチームと共有する必要があります。プロパティfcm_tokenを使用し、プロパティ値にはstring_valueフィールドを設定してください。

3. 配信の詳細

前提条件
  • FCMトークンは特定のユーザーを識別するために使用されます。
  • サービスアカウントのJSONキーは認証に使用されます。
  • サーバー上では、JSONキーを使用して短期間有効なOAuth 2.0アクセストークンを取得します。
  • アクセストークンは、FCMトークンをユーザー識別子として、send-message APIの呼び出しに使用されます。
Auxiaはデータのみのメッセージ(notificationオブジェクトなし)を使用します。title、body、imageを含むすべてのフィールドは、dataオブジェクトのキーと値のペアとして送信されます。これにより、AndroidとiOSの両方との互換性が確保されます。 ペイロードの例