Deprecate sendToDevice and sendToDeviceGroup and their response classes (#2090)

1. Deprecate sendToDevice and its response class, MessagingDeviceResponse
2. Deprecate sendToDeviceGroup and its response class, MessagingDeviceGroupResponse

Author: Doris-Ge

etc/firebase-admin.messaging.api.md

@@ -187,7 +187,9 @@ export class Messaging {
     sendAll(messages: Message[], dryRun?: boolean): Promise<BatchResponse>;
     sendMulticast(message: MulticastMessage, dryRun?: boolean): Promise<BatchResponse>;
     sendToCondition(condition: string, payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingConditionResponse>;
+    // @deprecated
     sendToDevice(registrationTokenOrTokens: string | string[], payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingDevicesResponse>;
+    // @deprecated
     sendToDeviceGroup(notificationKey: string, payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingDeviceGroupResponse>;
     sendToTopic(topic: string, payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingTopicResponse>;
     subscribeToTopic(registrationTokenOrTokens: string | string[], topic: string): Promise<MessagingTopicManagementResponse>;
@@ -199,22 +201,22 @@ export interface MessagingConditionResponse {
     messageId: number;
 }
 
-// @public
+// @public @deprecated
 export interface MessagingDeviceGroupResponse {
     failedRegistrationTokens: string[];
     failureCount: number;
     successCount: number;
 }
 
-// @public (undocumented)
+// @public @deprecated
 export interface MessagingDeviceResult {
     canonicalRegistrationToken?: string;
     // Warning: (ae-forgotten-export) The symbol "FirebaseError" needs to be exported by the entry point index.d.ts
     error?: FirebaseError;
     messageId?: string;
 }
 
-// @public
+// @public @deprecated
 export interface MessagingDevicesResponse {
     // (undocumented)
     canonicalRegistrationTokenCount: number;

src/messaging/messaging-api.ts

@@ -940,7 +940,11 @@ export interface MessagingOptions {
   [key: string]: any | undefined;
 }
 
-/* Individual status response payload from single devices */
+/**
+ * Individual status response payload from single devices
+ *
+ * @deprecated Returned by {@link Messaging#sendToDevice}, which is also deprecated.
+ */
 export interface MessagingDeviceResult {
   /**
    * The error that occurred when processing the message for the recipient.
@@ -967,6 +971,8 @@ export interface MessagingDeviceResult {
  * See
  * {@link https://firebase.google.com/docs/cloud-messaging/admin/send-messages#send_to_individual_devices |
  * Send to individual devices} for code samples and detailed documentation.
+ *
+ * @deprecated Returned by {@link Messaging.sendToDevice}, which is also deprecated.
  */
 export interface MessagingDevicesResponse {
   canonicalRegistrationTokenCount: number;
@@ -983,6 +989,8 @@ export interface MessagingDevicesResponse {
  * See
  * {@link https://firebase.google.com/docs/cloud-messaging/send-message?authuser=0#send_messages_to_device_groups |
  * Send messages to device groups} for code samples and detailed documentation.
+ *
+ * @deprecated Returned by {@link Messaging.sendToDeviceGroup}, which is also deprecated.
  */
 export interface MessagingDeviceGroupResponse {
 

src/messaging/messaging.ts

@@ -376,6 +376,8 @@ export class Messaging {
    *
    * @returns A promise fulfilled with the server's response after the message
    *   has been sent.
+   *
+   * @deprecated Use {@link Messaging.send} instead.
    */
   public sendToDevice(
     registrationTokenOrTokens: string | string[],
@@ -445,6 +447,8 @@ export class Messaging {
    *
    * @returns A promise fulfilled with the server's response after the message
    *   has been sent.
+   *
+   * @deprecated Use {@link Messaging.send} instead.
    */
   public sendToDeviceGroup(
     notificationKey: string,