웹/자바스크립트의 기기 그룹 메시징

기기 그룹 메시징을 사용하면 그룹에 속한 기기에서 실행되는 앱의 여러 인스턴스에 단일 메시지를 보낼 수 있습니다. 보통 '그룹'은 단일 사용자에게 속한 여러 기기의 모음을 의미하지만 그룹의 모든 기기는 공통의 알림 키를 공유합니다. 이 키는 FCM이 그룹의 모든 기기에 메시지를 전달하는 데 사용하는 토큰입니다.

Admin SDK를 사용하거나 앱 서버에서 XMPP 또는 HTTP 프로토콜을 구현하면 기기 그룹 메시징을 사용할 수 있습니다. 알림 키에 허용되는 최대 구성원 수는 20명입니다.

기기 그룹 관리

기기 그룹에 메시지를 보내려면 먼저 다음을 수행해야 합니다.

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

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

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

Android 클라이언트 앱의 경우 선택적으로 클라이언트 쪽에서 기기 그룹을 관리할 수 있습니다.

앱 서버에서 기기 그룹 관리

기기 그룹 만들기

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

HTTP POST 요청

https://android.googleapis.com/gcm/notification에 다음과 같이 요청을 보내세요.

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

{
   "operation": "create",
   "notification_key_name": "appUser-Chris",
   "registration_ids": ["4", "8", "15", "16", "23", "42"]
}

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://android.googleapis.com/gcm/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 요청

예를 들어 등록 ID가 51인 기기를 appUser-Chris에 추가하려면 다음 요청을 보냅니다.

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

응답 형식

기가 추가 또는 삭제에 성공하면 다음과 같이 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개에만 성공적으로 전송되었습니다. 메시지를 수신하지 못한 등록 토큰이 응답 메시지에 표시됩니다.

{
  "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 중 선택한 연결 서버 프로토콜에 맞는 참조 정보를 확인하세요.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.