chrome.instanceID

Descripción

Usa chrome.instanceID para acceder al servicio de ID de instancia.

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 él.

Parámetros

  • callback

    Función opcional

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

    ()=>void

Devuelve

  • Promise<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa 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

      cadena

      Chrome 46 y versiones posteriores

      Es la entidad autorizada que se usa para obtener el token.

    • permiso

      cadena

      Chrome 46 y versiones posteriores

      El alcance que se usa para obtener el token.

  • callback

    Función opcional

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

    ()=>void

Devuelve

  • Promise<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa 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 la 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

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

Devuelve

  • Promesa<number>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa 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 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

      cadena

      Un ID de instancia asignado a la instancia de la app

Devuelve

  • Promesa<string>

    Chrome 96 y versiones posteriores

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

getToken()

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

Devuelve un token que permite que la entidad autorizada acceda al servicio definido por el permiso.

Parámetros

  • getTokenParams

    objeto

    Parámetros para getToken.

    • authorizedEntity

      cadena

      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 de proyecto de Google Developers Console.

    • Opciones

      objeto opcional

      Chrome 46 y versiones posteriores Obsoleta desde Chrome 89

      estas opciones 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 se pueden usar para procesar la solicitud.

    • permiso

      cadena

      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

      cadena

      Un token que asigna el servicio solicitado.

Devuelve

  • Promesa<string>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa 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 se deben actualizar todos los tokens otorgados.

Parámetros

  • callback

    la función

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

    ()=>void