chrome.instanceID

Description

Accédez au service d'ID d'instance à l'aide de chrome.instanceID.

Autorisations

gcm

Disponibilité

Chrome (version 44 ou ultérieure)

Méthodes

deleteID()

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

Réinitialise l'identifiant d'instance d'application et révoque tous les jetons qui lui sont associés.

Paramètres

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

deleteToken()

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

Révoque un jeton accordé.

Paramètres

  • deleteTokenParams

    objet

    Paramètres de deleteToken.

    • authorizedEntity

      chaîne

      Chrome (version 46 ou ultérieure)

      Entité autorisée utilisée pour obtenir le jeton.

    • champ d'application

      chaîne

      Chrome (version 46 ou ultérieure)

      Champ d'application utilisé pour obtenir le jeton.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getCreationTime()

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

Récupère l'heure à laquelle l'ID d'instance a été généré. L'heure de création sera renvoyée par callback.

Paramètres

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (creationTime: number) => void

    • creationTime

      Nombre

      Heure à laquelle l'ID d'instance a été généré, représenté en millisecondes depuis l'époque.

Renvoie

  • Promise&lt;number&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getID()

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

Récupère un identifiant pour l'instance d'application. L'ID d'instance sera renvoyé par callback. Le même ID est renvoyé tant que l'identité de l'application n'a pas été révoquée ou n'a pas expiré.

Paramètres

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (instanceID: string) => void

    • instanceID

      chaîne

      ID d'instance attribué à l'instance d'application.

Renvoie

  • Promise&lt;string&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getToken()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)

Renvoyez un jeton qui permet à l'entité autorisée d'accéder au service défini par le champ d'application.

Paramètres

  • getTokenParams

    objet

    Paramètres pour getToken.

    • authorizedEntity

      chaîne

      Chrome (version 46 ou ultérieure)

      Identifie l'entité autorisée à accéder aux ressources associées à cet ID d'instance. Il peut s'agir d'un ID de projet provenant de la Google Play Console.

    • options

      objet facultatif

      Chrome (version 46 ou ultérieure) Obsolète depuis Chrome 89

      sont obsolètes et seront ignorées.

      Permet d'inclure un petit nombre de paires clé/valeur de chaîne qui seront associées au jeton et qui pourront être utilisées lors du traitement de la requête.

    • champ d'application

      chaîne

      Chrome (version 46 ou ultérieure)

      Identifie les actions autorisées que l'entité autorisée peut effectuer. Exemple : pour l'envoi de messages GCM, le champ d'application GCM doit être utilisé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (token: string) => void

    • jeton

      chaîne

      Jeton attribué par le service demandé.

Renvoie

  • Promise&lt;string&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

Événements

onTokenRefresh

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

Déclenché lorsque tous les jetons accordés doivent être actualisés.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

    () => void