chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Beschreibung

Verwenden Sie chrome.instanceID, um auf den Instanz-ID-Dienst zuzugreifen.

Berechtigungen

gcm

Verfügbarkeit

Chrome 44 oder höher

Methoden

deleteID()

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

Setzt die App-Instanz-ID zurück und widerruft alle damit verknüpften Tokens.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 oder höher

    Wird aufgelöst, wenn der Löschvorgang abgeschlossen ist. Die Instanz-ID wurde erfolgreich widerrufen, wenn das Promise nicht abgelehnt wird.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

deleteToken()

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

Widerruft ein gewährtes Token.

Parameter

  • deleteTokenParams

    Objekt

    Parameter für deleteToken.

    • authorizedEntity

      String

      Chrome 46 oder höher

      Das autorisierte Rechtssubjekt, das zum Abrufen des Tokens verwendet wird.

    • Bereich

      String

      Chrome 46 oder höher

      Der Bereich, der zum Abrufen des Tokens verwendet wird.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 oder höher

    Wird aufgelöst, wenn das Token gelöscht wurde. Das Token wurde erfolgreich widerrufen, wenn das Promise nicht abgelehnt wird.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getCreationTime()

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

Ruft den Zeitpunkt ab, zu dem die InstanceID generiert wurde. Die Erstellungszeit wird von callback zurückgegeben.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (creationTime: number) => void

    • creationTime

      Zahl

      Der Zeitpunkt, zu dem die Instanz-ID generiert wurde, in Millisekunden seit der Epoche.

Ausgabe

  • Promise<number>

    Chrome 96 oder höher

    Wird aufgelöst, wenn der Abruf abgeschlossen ist.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getID()

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

Ruft eine Kennung für die App-Instanz ab. Die Instanz-ID wird von callback zurückgegeben. Es wird dieselbe ID zurückgegeben, solange die Anwendungsidentität nicht widerrufen wurde oder abgelaufen ist.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (instanceID: string) => void

    • instanceID

      String

      Eine Instanz-ID, die der App-Instanz zugewiesen ist.

Ausgabe

  • Promise<string>

    Chrome 96 oder höher

    Wird aufgelöst, wenn der Abruf abgeschlossen ist.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getToken()

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

Gibt ein Token zurück, mit dem das autorisierte Rechtssubjekt auf den durch den Bereich definierten Dienst zugreifen kann.

Parameter

  • getTokenParams

    Objekt

    Parameter für getToken.

    • authorizedEntity

      String

      Chrome 46 oder höher

      Gibt die Entität an, die berechtigt ist, auf Ressourcen zuzugreifen, die mit dieser Instanz-ID verknüpft sind. Dies kann eine Projekt-ID aus der Google Developer Console sein.

    • Optionen

      Objekt optional

      Chrome 46 und höher Eingestellt seit Chrome 89

      -Optionen wurden verworfen und werden ignoriert.

      Ermöglicht das Einfügen einer kleinen Anzahl von String-Schlüssel/Wert-Paaren, die mit dem Token verknüpft werden und bei der Verarbeitung der Anfrage verwendet werden können.

    • Bereich

      String

      Chrome 46 oder höher

      Gibt autorisierte Aktionen an, die das autorisierte Rechtssubjekt ausführen kann. Zum Senden von GCM-Nachrichten sollte beispielsweise der Bereich GCM verwendet werden.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (token: string) => void

    • Token

      String

      Ein Token, das vom angeforderten Dienst zugewiesen wurde.

Ausgabe

  • Promise<string>

    Chrome 96 oder höher

    Wird aufgelöst, wenn der Abruf abgeschlossen ist.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onTokenRefresh

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

Wird ausgelöst, wenn alle gewährten Tokens aktualisiert werden müssen.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void