chrome.instanceID

Descripción

Usa chrome.instanceID para acceder al servicio Instance ID.

Permisos

gcm

Disponibilidad

Chrome 44 y versiones posteriores

Métodos

deleteID()

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

Restablece el identificador de instancias de la app y revoca todos los tokens asociados con ella.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promesa<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

deleteToken()

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

Revoca un token otorgado.

Parámetros

  • deleteTokenParams

    objeto

    Parámetros para deleteToken.

    • authorizedEntity

      string

      Chrome 46 y versiones posteriores

      La entidad autorizada que se usa para obtener el token.

    • alcance

      string

      Chrome 46 y versiones posteriores

      El permiso que se usa para obtener el token.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promesa<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getCreationTime()

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

Recupera la hora en que se generó el InstanceID. callback mostrará la hora de creación.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (creationTime: number) => void

    • creationTime

      número

      Indica el momento en que se generó el ID de la instancia, representado en milisegundos desde el ciclo de entrenamiento.

Muestra

  • Promise&lt;number&gt;

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getID()

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

Recupera un identificador para la instancia de la app. callback mostrará el ID de la instancia. Se mostrará el mismo ID siempre que la identidad de la aplicación no se haya revocado o haya vencido.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (instanceID: string) => void

    • instanceID

      string

      Un ID de instancia asignado a la instancia de la app.

Muestra

  • Promesa<string>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getToken()

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

Devolver un token que permita que la entidad autorizada acceda al servicio definido por el permiso.

Parámetros

  • getTokenParams

    objeto

    Parámetros para getToken.

    • authorizedEntity

      string

      Chrome 46 y versiones posteriores

      Identifica la entidad que está autorizada para acceder a los recursos asociados con este ID de instancia. Puede ser un ID del proyecto de la Consola para desarrolladores de Google.

    • opciones

      objeto opcional

      Chrome 46 y versiones posteriores Obsoleto desde Chrome 89

      están obsoletas y se ignorarán.

      Permite incluir una pequeña cantidad de pares clave-valor de cadena que se asociarán con el token y que se pueden usar para procesar la solicitud.

    • alcance

      string

      Chrome 46 y versiones posteriores

      Identifica las acciones autorizadas que puede realizar la entidad autorizada. P.ej., para enviar mensajes de GCM, se debe usar el alcance GCM.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (token: string) => void

    • token

      string

      Un token asignado por el servicio solicitado.

Muestra

  • Promesa<string>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

Eventos

onTokenRefresh

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

Se activa cuando todos los tokens otorgados deben actualizarse.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    () => void