Apple 플랫폼의 기기 그룹에 메시지 전송

기기 그룹 메시징을 사용하면 한 그룹에 여러 기기를 추가할 수 있습니다. 주제 메시징과 유사하지만 서버에서만 그룹 멤버십이 관리되도록 인증이 포함됩니다. 예를 들어 휴대전화 모델마다 다른 메시지를 보내려면 서버에서 알맞은 그룹에 등록을 추가/삭제하고 각 그룹에 적절한 메시지를 보내면 됩니다. 기기 그룹 메시징은 기기 그룹을 애플리케이션 내에서 직접 관리하는 것이 아니라 서버에서 관리한다는 점에서 주제 메시징과 다릅니다.

앱 서버에서 기존 XMPP 또는 HTTP 프로토콜을 통해 기기 그룹 메시징을 사용할 수 있습니다. 이전 버전의 Node.js용 Firebase Admin SDK는 기존 프로토콜을 기반으로 하고 기기 그룹 메시지 기능을 제공하기도 합니다. 알림 키 하나에 허용되는 최대 구성원 수는 20입니다.

기기 그룹 관리

기기 그룹에 메시지를 보내려면 먼저 다음 단계를 거쳐야 합니다.

  1. 그룹에 추가할 기기마다 등록 토큰을 받습니다.

  2. 보통은 사용자 1명으로 이루어진 특정 그룹을 그룹의 모든 관련 등록 토큰에 매핑하여 기기 그룹을 식별하는 notification_key를 만듭니다. 앱 서버에서 알림 키를 만들 수 있습니다.

그룹 만들기, 그룹 삭제, 기기 추가 또는 삭제와 같은 기본적인 기기 그룹 관리는 앱 서버를 통해 진행합니다. 지원되는 키 목록은 기존의 HTTP 프로토콜 참조를 확인하세요.

앱 서버에서 기기 그룹 관리

기기 그룹 만들기

기기 그룹을 만들려면 그룹의 이름 및 기기의 등록 토큰 목록을 제공하는 POST 요청을 보내세요. 그러면 FCM이 기기 그룹을 나타내는 새 notification_key를 반환합니다.

HTTP POST 요청

https://fcm.googleapis.com/fcm/notification에 다음과 같이 요청을 보냅니다.

https://fcm.googleapis.com/fcm/notification
Content-Type:application/json
Authorization:key=API_KEY
project_id:SENDER_ID

{
   "operation": "create",
   "notification_key_name": "appUser-Chris",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
                        "cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
                        ... ]

notification_key_name은 특정 그룹만의 이름 또는 식별자입니다. 예를 들어 사용자 이름일 수 있습니다. notification_key_namenotification_key는 등록 토큰 그룹에서 고유합니다. 동일한 발신자 ID에 여러 클라이언트 앱이 있는 경우 클라이언트 앱마다 notification_key_name이 달라야 합니다. 그래야 원하는 대상 앱으로만 메시지가 전달됩니다.

응답 형식

요청에 성공하면 다음과 같이 notification_key가 반환됩니다.

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

notification_key 및 해당하는 notification_key_name을 저장하여 후속 작업에서 사용하세요.

알림 키 검색하기

기존 알림 키를 검색해야 하는 경우 다음과 같이 GET 요청에서 notification_key_name을 사용합니다.

https://fcm.googleapis.com/fcm/notification?notification_key_name=appUser-Chris
Content-Type:application/json
Authorization:key=API_KEY
project_id:SENDER_ID
{}

특정 알림 키 이름에 대한 GET 요청마다 서버는 고유한 인코딩 문자열을 반환합니다. 각 문자열이 다른 키로 보일 수 있지만 실제로는 유효한 `notification_key` 값입니다.

기기 그룹에서 기기 추가 및 삭제

기존 그룹에서 기기를 추가하거나 삭제하려면 operation 매개변수가 add 또는 remove로 설정된 POST 요청을 보내고 추가 또는 삭제할 등록 토큰을 제공하세요.

HTTP POST 요청

예를 들어 등록 토큰이 bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...인 기기를 appUser-Chris에 추가하려면 다음 요청을 보냅니다.

{
   "operation": "add",
   "notification_key_name": "appUser-Chris",
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}

응답 형식

기기 추가 또는 삭제 요청에 성공하면 다음과 같이 notification_key가 반환됩니다.

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

기기 그룹에 다운스트림 메시지 전송

기기 그룹에 메시지를 보내는 것은 개별 기기에 메시지를 보내는 것과 매우 비슷합니다. to 매개변수를 기기 그룹의 고유 알림 키로 설정하세요. 페이로드 지원의 자세한 내용은 메시지 유형을 참조하세요. 이 페이지의 예시에서는 기존 HTTP 및 XMPP 프로토콜로 기기 그룹에 메시지를 보내는 방법을 확인할 수 있습니다.

기기 그룹 HTTP POST 요청

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA

{
  "to": "aUniqueKey",
  "data": {
    "hello": "This is a Firebase Cloud Messaging Device Group Message!",
   }
}

기기 그룹 HTTP 응답

다음은 '성공' 응답의 예시입니다. notification_key에 연결된 등록 토큰이 2개 있으며 메시지가 두 토큰에 모두 성공적으로 전송되었습니다.

{
  "success": 2,
  "failure": 0
}

다음은 '부분 성공' 응답의 예시입니다. notification_key에 연결된 등록 토큰이 3개 있습니다. 메시지가 등록 토큰 1개에만 성공적으로 전송되었습니다. 메시지를 수신하지 못한 등록 토큰(registration_ids)이 응답 메시지에 표시됩니다.

{
  "success":1,
  "failure":2,
  "failed_registration_ids":[
     "regId1",
     "regId2"
  ]
}

메시지가 notification_key에 연결된 등록 토큰 1개 이상에 전송되지 못하면 앱 서버에서 백오프를 두고 재시도하게 됩니다.

서버에서 메시지를 보내려는 기기 그룹에 구성원이 없는 경우 다음과 같이 응답의 성공, 실패가 모두 0입니다.

{
  "success": 0,
  "failure": 0
}

기기 그룹 XMPP 메시지

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "to": "aUniqueKey",
      "message_id": "m-1366082849205" ,
      "data": {
          "hello":"This is a Firebase Cloud Messaging Device Group Message!"
      }
  }
  </gcm>
</message>

기기 그룹 XMPP 응답

그룹에 메시지가 성공적으로 전송된 기기가 있으면 XMPP 연결 서버가 ACK로 응답합니다. 모든 메시지가 그룹의 모든 기기에 전송되지 못하면 XMPP 연결 서버가 NACK로 응답합니다.

다음은 '성공' 응답의 예시입니다. notification_key에 연결된 등록 토큰이 3개 있으며 메시지가 모든 토큰에 성공적으로 전송되었습니다.

{
  "from": "aUniqueKey",
  "message_type": "ack",
  "success": 3,
  "failure": 0,
  "message_id": "m-1366082849205"
}

다음은 '부분 성공' 응답의 예시입니다. notification_key에 연결된 등록 토큰이 3개 있습니다. 메시지가 등록 토큰 1개에만 성공적으로 전송되었습니다. 메시지를 수신하지 못한 등록 토큰이 응답 메시지에 표시됩니다.

{
  "from": "aUniqueKey",
  "message_type": "ack",
  "success":1,
  "failure":2,
  "failed_registration_ids":[
     "regId1",
     "regId2"
  ]
}

FCM 연결 서버가 그룹의 모든 기기에 전송하지 못하면 앱 서버가 NACK 응답을 수신합니다.

메시지 옵션의 전체 목록은 선택한 연결 서버 프로토콜인 HTTP 또는 XMPP에 대한 참조 정보를 확인하세요.

기기 그룹에 업스트림 메시지 전송

Apple 앱에서 기기 그룹에 업스트림 메시지를 보내려면 Apple 클라이언트 앱에 FIRMessaging.sendMessage를 구현해야 합니다.

(void)sendMessage:(nonnull NSDictionary *)message
     to:(nonnull NSString *)receiver
withMessageID:(nonnull NSString *)messageID
timeToLive:(int64_t)ttl;