chrome.instanceID

refresh date: 2026-09-25 robots: noindex

설명

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

권한

gcm

가용성

Chrome 44 이상

메서드

deleteID()

Promise 
chrome.instanceID.deleteID(
  callback?: function,
): Promise<void>

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

매개변수

  • callback

    함수 선택사항

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

    () => void

반환 값

  • 약속<void>

    Chrome 96 이상

    삭제가 완료되면 결정됩니다. 프로미스가 거부되지 않으면 인스턴스 식별자가 취소된 것입니다.

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

deleteToken()

Promise 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
): Promise<void>

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

매개변수

  • deleteTokenParams

    객체

    deleteToken의 매개변수입니다.

    • authorizedEntity

      문자열

      Chrome 46 이상

      토큰을 가져오는 데 사용되는 허가를 받은 대상입니다.

    • 범위

      문자열

      Chrome 46 이상

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • 약속<void>

    Chrome 96 이상

    토큰 삭제가 완료되면 결정됩니다. 프로미스가 거부되지 않으면 토큰이 취소된 것입니다.

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

getCreationTime()

Promise 
chrome.instanceID.getCreationTime(
  callback?: function,
): Promise<number>

InstanceID가 생성된 시간을 가져옵니다. 생성 시간은 callback에서 반환됩니다.

매개변수

  • callback

    함수 선택사항

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

    (creationTime: number) => void

    • creationTime

      숫자

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

반환 값

  • <number> 약속

    Chrome 96 이상

    검색이 완료되면 확인됩니다.

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

getID()

Promise 
chrome.instanceID.getID(
  callback?: function,
): Promise<string>

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

매개변수

  • callback

    함수 선택사항

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

    (instanceID: string) => void

    • instanceID

      문자열

      앱 인스턴스에 할당된 인스턴스 ID입니다.

반환 값

  • Promise<string>

    Chrome 96 이상

    검색이 완료되면 확인됩니다.

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

getToken()

Promise 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
): Promise<string>

허가된 대상이 범위에 정의된 서비스에 액세스할 수 있도록 허용하는 토큰을 반환합니다.

매개변수

  • getTokenParams

    객체

    getToken의 매개변수입니다.

    • authorizedEntity

      문자열

      Chrome 46 이상

      이 인스턴스 ID와 연결된 리소스에 액세스할 수 있는 항목을 식별합니다. Google Developers의 프로젝트 ID일 수 있습니다.

    • 옵션

      객체 선택사항

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

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

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

    • 범위

      문자열

      Chrome 46 이상

      허가를 받은 대상이 수행할 수 있는 승인된 작업을 식별합니다. 예를 들어 GCM 메시지를 전송하려면 GCM 범위를 사용해야 합니다.

  • callback

    함수 선택사항

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

    (token: string) => void

    • 토큰

      문자열

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

반환 값

  • Promise<string>

    Chrome 96 이상

    검색이 완료되면 확인됩니다.

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

이벤트

onTokenRefresh

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

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

매개변수

  • callback

    함수

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

    () => void