chrome.instanceID

Beschreibung

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

Berechtigungen

gcm

Verfügbarkeit

Chrome 44 und höher

Methoden

deleteID()

Versprechen 
chrome.instanceID.deleteID(
  callback?: function,
)

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

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

deleteToken()

Versprechen 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)

Hebt ein erteiltes Token auf.

Parameters

  • deleteTokenParams

    Objekt

    Parameter für "deleteToken".

    • authorizedEntity

      String

      Chrome 46 und höher

      Die autorisierte Entität, die zum Abrufen des Tokens verwendet wird.

    • Bereich

      String

      Chrome 46 und höher

      Der Bereich, in dem das Token abgerufen wird.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getCreationTime()

Versprechen 
chrome.instanceID.getCreationTime(
  callback?: function,
)

Ruft den Zeitpunkt ab, zu dem die InstanceID generiert wurde. Der Erstellungszeitpunkt wird vom callback zurückgegeben.

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (creationTime: number)=>void

    • creationTime

      Zahl

      Die Zeit, zu der die Instanz-ID generiert wurde, dargestellt in Millisekunden seit der Epoche.

Rückgaben

  • Versprechen<Zahl>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getID()

Versprechen 
chrome.instanceID.getID(
  callback?: function,
)

Ruft eine ID für die Anwendungsinstanz ab. Die Instanz-ID wird vom callback zurückgegeben. Solange die Anwendungsidentität nicht widerrufen wurde oder abgelaufen ist, wird dieselbe ID zurückgegeben.

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (instanceID: string)=>void

    • instanceID

      String

      Eine Instanz-ID, die der Anwendungsinstanz zugewiesen ist.

Rückgaben

  • Versprechen<string>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getToken()

Versprechen 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)

Gibt ein Token zurück, das der autorisierten Entität den Zugriff auf den durch den Bereich definierten Dienst ermöglicht.

Parameters

  • getTokenParams

    Objekt

    Parameter für getToken.

    • authorizedEntity

      String

      Chrome 46 und höher

      Identifiziert die Entität, die für den Zugriff auf Ressourcen berechtigt ist, die mit dieser Instanz-ID verknüpft sind. Das kann eine Projekt-ID aus der Google Developer Console sein.

    • Optionen

      Objekt optional

      Chrome 46 oder höher Seit Chrome 89 eingestellt

      -Optionen sind veraltet und werden ignoriert.

      Ermöglicht das Einbinden einer kleinen Anzahl von String-Schlüssel/Wert-Paaren, die dem Token zugeordnet werden und zur Verarbeitung der Anfrage verwendet werden können.

    • Bereich

      String

      Chrome 46 und höher

      Identifiziert autorisierte Aktionen, die die autorisierte Entität ausführen kann. Zum Beispiel sollte zum Senden von GCM-Nachrichten der Gültigkeitsbereich GCM verwendet werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (token: string)=>void

    • Token

      String

      Ein Token, das vom angeforderten Dienst zugewiesen wurde.

Rückgaben

  • Versprechen<string>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

Veranstaltungen

onTokenRefresh

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

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

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    ()=>void