chrome.instanceID

설명

chrome.instanceID를 사용하여 인스턴스 ID 서비스에 액세스합니다.

권한

gcm

지원 대상

Chrome 44 이상

방법

deleteID()

프로미스 
chrome.instanceID.deleteID(
  callback?: function,
)

앱 인스턴스 식별자를 재설정하고 연결된 모든 토큰을 취소합니다.

매개변수

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

deleteToken()

프로미스 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)

부여된 토큰을 취소합니다.

매개변수

  • deleteTokenParams

    객체

    deleteToken의 매개변수입니다.

    • authorizedEntity

      string

      Chrome 46 이상

      토큰을 얻는 데 사용되는 승인된 개체입니다.

    • 범위

      string

      Chrome 46 이상

      토큰을 가져오는 데 사용되는 범위입니다.

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getCreationTime()

프로미스 
chrome.instanceID.getCreationTime(
  callback?: function,
)

InstanceID가 생성된 시간을 검색합니다. 생성 시간은 callback에서 반환합니다.

매개변수

  • 콜백

    함수 선택사항

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

    (creationTime: number)=>void

    • creationTime

      숫자

      인스턴스 ID가 생성된 시간으로, 에포크 이후 밀리초 단위로 표시됩니다.

반환 값

  • 프로미스<number>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getID()

프로미스 
chrome.instanceID.getID(
  callback?: function,
)

앱 인스턴스의 식별자를 검색합니다. 인스턴스 ID는 callback에서 반환합니다. 애플리케이션 ID가 취소되거나 만료되지 않은 한 동일한 ID가 반환됩니다.

매개변수

  • 콜백

    함수 선택사항

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

    (instanceID: string)=>void

    • instanceID

      string

      앱 인스턴스에 할당된 인스턴스 ID

반환 값

  • 프로미스<string>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getToken()

프로미스 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)

권한이 있는 항목이 범위로 정의된 서비스에 액세스할 수 있도록 허용하는 토큰을 반환합니다.

매개변수

  • getTokenParams

    객체

    getToken의 매개변수입니다.

    • authorizedEntity

      string

      Chrome 46 이상

      이 인스턴스 ID와 연결된 리소스에 액세스하도록 승인된 항목을 식별합니다. Google 개발자 콘솔의 프로젝트 ID일 수 있습니다.

    • 옵션

      객체 선택사항

      Chrome 46 이상 Chrome 89부터 지원 중단됨

      옵션은 지원 중단되었으며 무시됩니다.

      토큰과 연결되고 요청을 처리하는 데 사용할 수 있는 소수의 문자열 키/값 쌍을 포함할 수 있습니다.

    • 범위

      string

      Chrome 46 이상

      권한이 있는 법인이 취할 수 있는 승인된 작업을 식별합니다. 예를 들어 GCM 메시지를 전송하려면 GCM 범위를 사용해야 합니다.

  • 콜백

    함수 선택사항

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

    (token: string)=>void

    • 토큰

      string

      요청한 서비스에서 할당한 토큰입니다.

반환 값

  • 프로미스<string>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

이벤트

onTokenRefresh

chrome.instanceID.onTokenRefresh.addListener(
  callback: function,
)

부여된 모든 토큰을 새로고침해야 할 때 실행됩니다.

매개변수

  • 콜백

    기능

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

    ()=>void