feat(fcm): Enable fid and deprecate token for Send API

FirebaseAdmin/FirebaseAdmin.IntegrationTests/FirebaseMessagingTest.cs

@@ -120,11 +120,13 @@ public async Task SendEachForMulticast()
                     TimeToLive = TimeSpan.FromHours(1),
                     RestrictedPackageName = "com.google.firebase.testing",
                 },
+#pragma warning disable CS0618
                 Tokens = new[]
                 {
                     "token1",
                     "token2",
                 },
+#pragma warning restore CS0618
             };
             var response = await FirebaseMessaging.DefaultInstance.SendEachForMulticastAsync(multicastMessage, dryRun: true);
             Assert.NotNull(response);
@@ -133,6 +135,35 @@ public async Task SendEachForMulticast()
             Assert.NotNull(response.Responses[1].Exception);
         }
 
+        [Fact]
+        public async Task SendEachForMulticastFids()
+        {
+            var multicastMessage = new MulticastMessage
+            {
+                Notification = new Notification()
+                {
+                    Title = "Title",
+                    Body = "Body",
+                },
+                Android = new AndroidConfig()
+                {
+                    Priority = Priority.Normal,
+                    TimeToLive = TimeSpan.FromHours(1),
+                    RestrictedPackageName = "com.google.firebase.testing",
+                },
+                Fids = new[]
+                {
+                    "fid1",
+                    "fid2",
+                },
+            };
+            var response = await FirebaseMessaging.DefaultInstance.SendEachForMulticastAsync(multicastMessage, dryRun: true);
+            Assert.NotNull(response);
+            Assert.Equal(2, response.FailureCount);
+            Assert.Equal(MessagingErrorCode.Unregistered, response.Responses[0].Exception.MessagingErrorCode);
+            Assert.Equal(MessagingErrorCode.Unregistered, response.Responses[1].Exception.MessagingErrorCode);
+        }
+
         [Fact]
         public async Task SubscribeToTopic()
         {

FirebaseAdmin/FirebaseAdmin.Snippets/FirebaseExceptionSnippets.cs

@@ -102,6 +102,40 @@ internal static async Task PlatformErrorCode(string deviceToken)
             // [END platform_error_code]
         }
 
+        internal static async Task PlatformErrorCodeWithFid(string fid)
+        {
+            // [START platform_error_code_fid]
+            var notification = CreateNotificationWithFid(fid);
+            try
+            {
+                await FirebaseMessaging.DefaultInstance.SendAsync(notification);
+            }
+            catch (FirebaseMessagingException ex)
+            {
+                // All exceptions contain a platform-level error code. Applications can inspect
+                // both the platform-level error code and any service-level error codes when
+                // implementing error handling logic.
+                if (ex.MessagingErrorCode == MessagingErrorCode.Unregistered)
+                {
+                    // Service-level error code
+                    Console.WriteLine("App instance has been unregistered");
+                    RemoveFidFromDatabase(fid);
+                }
+                else if (ex.ErrorCode == ErrorCode.Unavailable)
+                {
+                    // Platform-level error code
+                    Console.WriteLine("FCM service is temporarily unavailable");
+                    ScheduleForRetry(notification, TimeSpan.FromHours(1));
+                }
+                else
+                {
+                    Console.WriteLine($"Failed to send notification: {ex.Message}");
+                }
+            }
+
+            // [END platform_error_code_fid]
+        }
+
         internal static async Task HttpResponse(string deviceToken)
         {
             // [START http_response]
@@ -133,13 +167,58 @@ internal static async Task HttpResponse(string deviceToken)
             // [END http_response]
         }
 
+        internal static async Task HttpResponseWithFid(string fid)
+        {
+            // [START http_response_fid]
+            var notification = CreateNotificationWithFid(fid);
+            try
+            {
+                await FirebaseMessaging.DefaultInstance.SendAsync(notification);
+            }
+            catch (FirebaseMessagingException ex)
+            {
+                // If the exception was caused by a backend service error, applications can
+                // inspect the original error response received from the backend service to
+                // implement more advanced error handling behavior.
+                var response = ex.HttpResponse;
+                if (response != null)
+                {
+                    Console.WriteLine($"FCM service responded with HTTP {response.StatusCode}");
+                    foreach (var entry in response.Headers)
+                    {
+                        Console.WriteLine($">>> {entry.Key}: {entry.Value}");
+                    }
+
+                    var body = await response.Content.ReadAsStringAsync();
+                    Console.WriteLine(">>>");
+                    Console.WriteLine($">>> {body}");
+                }
+            }
+
+            // [END http_response_fid]
+        }
+
         private static void PerformPrivilegedOperation(string uid) { }
 
         private static Message CreateNotification(string deviceToken)
         {
             return new Message()
             {
+#pragma warning disable CS0618
                 Token = deviceToken,
+#pragma warning restore CS0618
+                Notification = new Notification()
+                {
+                    Title = "Test notification",
+                },
+            };
+        }
+
+        private static Message CreateNotificationWithFid(string fid)
+        {
+            return new Message()
+            {
+                Fid = fid,
                 Notification = new Notification()
                 {
                     Title = "Test notification",
@@ -149,6 +228,8 @@ private static Message CreateNotification(string deviceToken)
 
         private static void RemoveTokenFromDatabase(string deviceToken) { }
 
+        private static void RemoveFidFromDatabase(string fid) { }
+
         private static void ScheduleForRetry(Message message, TimeSpan waitTime) { }
     }
 }

FirebaseAdmin/FirebaseAdmin.Snippets/FirebaseMessagingSnippets.cs

@@ -35,7 +35,9 @@ internal static async Task SendToTokenAsync()
                     { "score", "850" },
                     { "time", "2:45" },
                 },
+#pragma warning disable CS0618
                 Token = registrationToken,
+#pragma warning restore CS0618
             };
 
             // Send a message to the device corresponding to the provided
@@ -105,7 +107,9 @@ internal static async Task SendDryRunAsync()
                     { "score", "850" },
                     { "time", "2:45" },
                 },
+#pragma warning disable CS0618
                 Token = "token",
+#pragma warning restore CS0618
             };
 
             // [START send_dry_run]
@@ -131,7 +135,9 @@ internal static async Task SendEachAsync()
                         Title = "Price drop",
                         Body = "5% off all electronics",
                     },
+#pragma warning disable CS0618
                     Token = registrationToken,
+#pragma warning restore CS0618
                 },
                 new Message()
                 {
@@ -164,7 +170,9 @@ internal static async Task SendEachForMulticastAsync()
             };
             var message = new MulticastMessage()
             {
+#pragma warning disable CS0618
                 Tokens = registrationTokens,
+#pragma warning restore CS0618
                 Data = new Dictionary<string, string>()
                 {
                     { "score", "850" },
@@ -191,7 +199,9 @@ internal static async Task SendEachForMulticastAndHandleErrorsAsync()
             };
             var message = new MulticastMessage()
             {
+#pragma warning disable CS0618
                 Tokens = registrationTokens,
+#pragma warning restore CS0618
                 Data = new Dictionary<string, string>()
                 {
                     { "score", "850" },