chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza chrome.instanceID per accedere al servizio ID istanza.

Autorizzazioni

gcm

Disponibilità

Chrome 44 e versioni successive

Metodi

deleteID()

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

Reimposta l'identificatore dell'istanza dell'app e revoca tutti i token associati.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Viene risolta al termine dell'eliminazione. L'identificatore dell'istanza è stato revocato correttamente se la promise non viene rifiutata.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

deleteToken()

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

Revoca un token concesso.

Parametri

  • deleteTokenParams

    oggetto

    Parametri per deleteToken.

    • authorizedEntity

      stringa

      Chrome 46+

      Il soggetto autorizzato utilizzato per ottenere il token.

    • ambito

      stringa

      Chrome 46 e versioni successive

      L'ambito utilizzato per ottenere il token.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve al termine dell'eliminazione del token. Il token è stato revocato correttamente se la promessa non viene rifiutata.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getCreationTime()

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

Recupera l'ora in cui è stato generato l'ID istanza. L'ora di creazione verrà restituita da callback.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (creationTime: number) => void

    • creationTime

      numero

      L'ora in cui è stato generato l'ID istanza, rappresentata in millisecondi dall'epoca.

Resi

  • Promise<number>

    Chrome 96 e versioni successive

    Viene risolta al termine del recupero.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getID()

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

Recupera un identificatore per l'istanza dell'app. L'ID istanza verrà restituito da callback. Verrà restituito lo stesso ID, a meno che l'identità dell'applicazione non sia stata revocata o non sia scaduta.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (instanceID: string) => void

    • instanceID

      stringa

      Un ID istanza assegnato all'istanza dell'app.

Resi

  • Promise<string>

    Chrome 96 e versioni successive

    Viene risolta al termine del recupero.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getToken()

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

Restituisce un token che consente al soggetto autorizzato di accedere al servizio definito dall'ambito.

Parametri

  • getTokenParams

    oggetto

    Parametri per getToken.

    • authorizedEntity

      stringa

      Chrome 46+

      Identifica l'entità autorizzata ad accedere alle risorse associate a questo ID istanza. Può essere un ID progetto di Google Developers Console.

    • opzioni

      object facoltativo

      Chrome 46 e versioni successive Ritirato da Chrome 89

      sono deprecate e verranno ignorate.

      Consente di includere un numero ridotto di coppie chiave/valore di stringhe che verranno associate al token e che potrebbero essere utilizzate nell'elaborazione della richiesta.

    • ambito

      stringa

      Chrome 46+

      Identifica le azioni autorizzate che il soggetto autorizzato può intraprendere. Ad esempio, per l'invio di messaggi GCM, deve essere utilizzato l'ambito GCM.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (token: string) => void

    • token

      stringa

      Un token assegnato dal servizio richiesto.

Resi

  • Promise<string>

    Chrome 96 e versioni successive

    Si risolve al termine del recupero.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onTokenRefresh

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

Attivato quando tutti i token concessi devono essere aggiornati.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void