chrome.gcm

설명

chrome.gcm를 사용하여 앱 및 확장 프로그램이 Firebase 클라우드 메시징 (FCM)을 통해 메시지를 주고받도록 사용 설정합니다.

권한

gcm

속성

MAX_MESSAGE_SIZE

메시지에 포함된 모든 키-값 쌍의 최대 크기 (바이트)입니다.

값

4096

메서드

register()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.gcm.register(
  senderIds: string[],
  callback?: function,
)

FCM에 애플리케이션을 등록합니다. 등록 ID는 callback에서 반환됩니다. register가 동일한 senderIds 목록으로 다시 호출되면 동일한 등록 ID가 반환됩니다.

매개변수

  • senderIds

    문자열[]

    애플리케이션에 메시지를 보낼 수 있는 서버 ID 목록입니다. 발신자 ID는 최소 1개에서 100개까지 포함해야 합니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (registrationId: string) => void

    • registrationId

      문자열

      FCM에서 애플리케이션에 할당한 등록 ID입니다.

반환 값

  • 프로미스<string>

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

send()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.gcm.send(
  message: object,
  callback?: function,
)

내용에 따라 메시지를 보냅니다.

매개변수

  • 메시지

    객체

    FCM을 통해 상대방에게 보낼 메시지입니다.

    • 데이터

      객체

      서버로 보낼 메시지 데이터입니다. 대소문자를 구분하지 않는 goog. 및 google와 대소문자를 구분하는 collapse_key는 키 접두사로 허용되지 않습니다. 모든 키-값 쌍의 합계가 gcm.MAX_MESSAGE_SIZE 이하여야 합니다.

    • destinationId

      문자열

      Google API 콘솔에서 할당한 메시지를 전송할 서버의 ID입니다.

    • messageId

      문자열

      메시지의 ID입니다. 애플리케이션 범위 내의 각 메시지에 대해 고유해야 합니다. ID 선택 및 처리에 대한 도움말은 클라우드 메시징 문서를 참조하세요.

    • timeToLive

      숫자 선택사항

      메시지의 TTL(수명)(초)입니다. 이 시간 내에 메시지를 보낼 수 없으면 onSendError 이벤트가 발생합니다. TTL(수명)이 0이면 메시지를 즉시 전송하거나 전송할 수 없는 경우 실패해야 함을 나타냅니다. TTL(수명)의 기본값은 86,400초(1일)이고 최댓값은 2,419,200초(28일)입니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (messageId: string) => void

    • messageId

      문자열

      콜백이 발급된 메시지의 ID입니다.

반환 값

  • 프로미스<string>

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

unregister()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.gcm.unregister(
  callback?: function,
)

FCM에서 애플리케이션을 등록 취소합니다.

매개변수

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 프로미스<void>

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

onMessage

chrome.gcm.onMessage.addListener(
  callback: function,
)

FCM을 통해 메시지가 수신되면 실행됩니다.

매개변수

  • 콜백

    함수

    callback 매개변수는 다음과 같습니다. 

    (message: object) => void

    • 메시지

      객체

      • collapseKey

        문자열(선택사항)

        메시지의 접기 키입니다. 자세한 내용은 비축소형 메시지 및 축소형 메시지를 참고하세요.

      • 데이터

        객체

        메시지 데이터입니다.

      • 출처:

        문자열(선택사항)

        메시지를 발행한 발신자입니다.

onMessagesDeleted

chrome.gcm.onMessagesDeleted.addListener(
  callback: function,
)

앱 서버에서 애플리케이션으로 보낸 메시지를 FCM 서버가 삭제해야 할 때 실행됩니다. 이 이벤트 처리에 관한 자세한 내용은 메시지의 전체 기간을 참고하세요.

매개변수

  • 콜백

    함수

    callback 매개변수는 다음과 같습니다. 

    () => void

onSendError

chrome.gcm.onSendError.addListener(
  callback: function,
)

FCM 서버에 메시지를 보낼 수 없을 때 실행됩니다.

매개변수

  • 콜백

    함수

    callback 매개변수는 다음과 같습니다. 

    (error: object) => void

    • 오류

      객체

      • 세부정보

        객체

        오류와 관련된 추가 세부정보입니다(있는 경우).

      • errorMessage

        문자열

        문제를 설명하는 오류 메시지입니다.

      • messageId

        문자열(선택사항)

        오류가 특정 메시지와 관련된 경우 이 오류가 있는 메시지의 ID입니다.