chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik chrome.instanceID om toegang te krijgen tot de Instance ID-service.

Rechten

gcm

Beschikbaarheid

Chrome 44+

Methoden

deleteID()

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

Hiermee wordt de ID van de app-instantie gereset en worden alle bijbehorende tokens ingetrokken.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 96+

    Wordt opgelost als de verwijdering is afgerond. De instantie-ID is ingetrokken als de promise niet wordt afgewezen.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

deleteToken()

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

Trekt een verleend token in.

Parameters

  • deleteTokenParams

    object

    Parameters voor deleteToken.

    • authorizedEntity

      tekenreeks

      Chrome 46+

      De gemachtigde entiteit die wordt gebruikt om de token te verkrijgen.

    • bereik

      tekenreeks

      Chrome 46+

      Het bereik dat wordt gebruikt om de token te verkrijgen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 96+

    Wordt opgelost als de tokenverwijdering is afgerond. De token is ingetrokken als de promise niet wordt afgewezen.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getCreationTime()

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

Haalt de tijd op waarop de InstanceID is gegenereerd. De aanmaaktijd wordt geretourneerd door de callback.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (creationTime: number) => void

    • creationTime

      getal

      De tijd waarop de instantie-ID is gegenereerd, weergegeven in milliseconden sinds het tijdvak.

Retourzendingen

  • Promise<number>

    Chrome 96+

    Wordt opgelost als het ophalen is afgerond.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getID()

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

Haalt een ID voor de app-instantie op. De instantie-ID wordt geretourneerd door de callback. Dezelfde ID wordt geretourneerd zolang de app-identiteit niet is ingetrokken of verlopen.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (instanceID: string) => void

    • instanceID

      tekenreeks

      Een instantie-ID die is toegewezen aan de app-instantie.

Retourzendingen

  • Promise<string>

    Chrome 96+

    Wordt opgelost als het ophalen is afgerond.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getToken()

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

Retourneer een token waarmee de gemachtigde entiteit toegang krijgt tot de service die is gedefinieerd door het bereik.

Parameters

  • getTokenParams

    object

    Parameters voor getToken.

    • authorizedEntity

      tekenreeks

      Chrome 46+

      Identificeert de entiteit die is geautoriseerd voor toegang tot bronnen die aan deze instantie-ID zijn gekoppeld. Dit kan een project-ID uit de Google Developer Console zijn.

    • opties

      object optioneel

      Chrome 46+ Beëindigd sinds Chrome 89

      -opties zijn beëindigd en worden genegeerd.

      Hiermee kun je een klein aantal sleutel/waarde-paren voor tekenreeksen opnemen die aan de token worden gekoppeld en kunnen worden gebruikt bij de verwerking van het verzoek.

    • bereik

      tekenreeks

      Chrome 46+

      Geeft aan welke acties de gemachtigde entiteit mag uitvoeren. Voor het sturen van GCM-berichten moet bijvoorbeeld het bereik GCM worden gebruikt.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (token: string) => void

    • token

      tekenreeks

      Een token dat is toegewezen door de aangevraagde service.

Retourzendingen

  • Promise<string>

    Chrome 96+

    Wordt opgelost als het ophalen is afgerond.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onTokenRefresh

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

Wordt geactiveerd als alle verleende tokens moeten worden vernieuwd.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    () => void