Azure Notification Hubs および Google Firebase Cloud Messaging の移行
Azure Notification Hubs の Firebase Cloud Messaging (FCM) v1 との統合のコア機能を使用できます。 注意喚起としてですが、Google は 2024 年 6 月 20 日に FCM レガシ HTTP のサポートを停止するため、その前にアプリケーションと通知ペイロードを新しい形式に移行する必要があります。
重要
2024 年 6 月の時点で、FCM レガシ API はサポートされなくなり、廃止される予定です。 プッシュ通知サービスの中断を回避するには、できるだけ早く FCM v1 プロトコルに移行する必要があります。
FCM v1 の概念
- FCM v1 という名前の新しいプラットフォームの種類がサポートされるようになります。
- FCM v1 には、新しい API、資格情報、登録、インストールが使われます。
移行の手順
Firebase Cloud Messaging (FCM) レガシ API は、2024 年 7 月までに非推奨になります。 レガシ HTTP プロトコルから FCM v1 への移行を開始できるようになりました。 移行は 2024 年 6 月までに完了する必要があります。
- Azure SDK を使った FCM レガシから FCM v1 への移行については、SDK を使った Google Firebase Cloud Messaging (FCM) の移行に関する記事を参照してください。
- Azure REST API を使った FCM レガシから FCM v1 への移行については、REST API を使った Google Firebase Cloud Messaging (FCM) の移行に関する記事を参照してください。
- FCM 移行に関する最新情報については、Firebase Cloud Messaging 移行ガイドを参照してください。
よく寄せられる質問
このセクションでは、FCM レガシから FCM v1 への移行に関し、よく寄せられる質問への回答を示します。
SDK または REST API を使用して FCM v1 テンプレート登録を作成するにはどうすればよいですか?
FCM v1 テンプレートの登録を作成する方法については、「SDK を使った Azure Notification Hubs と Google Firebase Cloud Messaging (FCM) の移行」を参照してください。
FCM レガシ資格情報と FCM v1 資格情報の両方を格納する必要がありますか?
はい。FCM レガシと FCM v1 は、Azure Notification Hubs で 2 つの異なるプラットフォームとして扱われるので、FCM レガシ資格情報と FCM v1 資格情報の両方を個別に格納する必要があります。 詳細については、資格情報を設定する手順を参照してください。
送信操作が FCM レガシ パイプラインでなく FCM v1 パイプラインを通過していることを確認するには、どうすればよいですか?
デバッグ送信応答には、results
プロパティが含まれています。これは、デバッグ送信のための登録結果の配列です。 各登録結果では、アプリケーション プラットフォームが指定されます。 さらに、Standard レベルの通知ハブに対してメッセージごとのテレメトリが提供されます。 このテレメトリ機能 GcmOutcomeCounts
と FcmV1OutcomeCounts
は、送信操作に使用されるプラットフォームを確認するのに役立ちます。
FCM v1 の新しい登録を作成する必要がありますか?
はい。ただし、インポートおよびエクスポートを使用できます。 クライアント SDK を更新すると、FCM v1 登録のデバイス トークンが作成されます。
Google Firebase のドキュメントによると、クライアント側の変更は必要ありません。 通知が FCM v1 経由で確実に送信されるように、Notification Hubs に変更を加える必要はありますか?
直接送信操作の場合、クライアント デバイスで行う必要がある Notification Hubs 固有の変更はありません。 Azure Notification Hubs にインストールまたは登録を保存する場合は、移行されたプラットフォーム (FCM v1) をリッスンすることを Notification Hubs に通知する必要があります。 Notification Hubs と Firebase のどちらを直接使用するかに関係なく、ペイロードの変更が必要です。 FCM v1 に移行する方法に関するドキュメントを参照してください。
FCM v1 メッセージを送信すると、PNS フィードバックに "不明なエラー" が表示されます。 このエラーを修正するには、どうすればよいですか?
Azure Notification Hubs では、"不明なエラー" が表示される回数を減らすべく解決に取り組んでいます。 それまでの間は、Standard レベルのお客様は、通知フィードバック API を使用して応答を調べることができます。
Xamarin のユーザーはどのような方法で FCM v1 に移行できますか?
Xamarin は非推奨になったため、Xamarin のお客様は NET Multi-platform App UI (.NET MAUI) に移行する必要があります。 .NET for Android、.NET for iOS、.NET MAUI に対して特定の Azure Notification Hub SDK は提供されていませんが、.NET SDK は .NET で構築されたアプリ (.NET MAUI を含む) で使用できます。 FCM v1 経由で .NET MAUI アプリにプッシュ通知を送信する方法などの詳細については、「バックエンド サービス経由で Azure Notification Hubs を使用して .NET MAUI アプリにプッシュ通知を送信する」を参照してください。