chrome.instanceID

Beschreibung

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

Berechtigungen

gcm

Verfügbarkeit

Chrome (ab Version 44)

Methoden

deleteID()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.instanceID.deleteID(
  callback?: function,
)

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

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 96 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

deleteToken()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)

Widerruft ein gewährtes Token.

Parameter

  • deleteTokenParams

    Objekt

    Parameter für deleteToken.

    • authorizedEntity

      String

      Chrome (ab Version 46)

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

    • Bereich

      String

      Chrome (ab Version 46)

      Der Bereich, der zum Abrufen des Tokens verwendet wird.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 96 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getCreationTime()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.instanceID.getCreationTime(
  callback?: function,
)

Ruft die Uhrzeit ab, zu der die InstanceID generiert wurde. Die Erstellungszeit wird von callback zurückgegeben.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (creationTime: number) => void

    • creationTime

      Zahl

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

Gibt Folgendes zurück:

  • Promise&lt;number&gt;

    Chrome 96 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getID()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.instanceID.getID(
  callback?: function,
)

Ruft eine Kennung für die Anwendungsinstanz ab. Die Instanz-ID wird von callback zurückgegeben. Dieselbe ID wird zurückgegeben, solange die Identität der Anwendung nicht widerrufen wurde oder abgelaufen ist.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (instanceID: string) => void

    • instanceID

      String

      Eine Instanz-ID, die der Anwendungsinstanz zugewiesen ist.

Gibt Folgendes zurück:

  • Promise&lt;string&gt;

    Chrome 96 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getToken()

<ph type="x-smartling-placeholder"></ph> 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.

Parameter

  • getTokenParams

    Objekt

    Parameter für getToken.

    • authorizedEntity

      String

      Chrome (ab Version 46)

      Gibt die Entität an, die für den Zugriff auf Ressourcen autorisiert ist, die mit dieser Instanz-ID verknüpft sind. Es kann sich um eine Projekt-ID aus der Google Developer Console handeln.

    • Optionen

      Objekt optional

      Chrome (ab Version 46) Seit Chrome 89 eingestellt

      Optionen sind veraltet und werden ignoriert.

      Ermöglicht die Aufnahme 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 (ab Version 46)

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (token: string) => void

    • Token

      String

      Ein Token, das vom angeforderten Dienst zugewiesen wurde.

Gibt Folgendes zurück:

  • Promise&lt;string&gt;

    Chrome 96 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

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: <ph type="x-smartling-placeholder"></ph>

    () => void