chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Descripción

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

Permisos

gcm

Disponibilidad

Chrome 44 y versiones posteriores

Métodos

deleteID()

Promise 
chrome.instanceID.deleteID(
  callback?: function,
): Promise<void>

Restablece el identificador de la instancia de la app y revoca todos los tokens asociados a ella.

Parámetros

  • callback

    función opcional

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

    () => void

Muestra

  • Promise<void>

    Chrome 96 y versiones posteriores

    Se resuelve cuando se completa la eliminación. El identificador de instancia se revocó correctamente si la promesa no se rechaza.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

deleteToken()

Promise 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
): Promise<void>

Revoca un token otorgado.

Parámetros

  • deleteTokenParams

    objeto

    Parámetros para deleteToken.

    • authorizedEntity

      string

      Chrome 46 y versiones posteriores

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

    • alcance

      string

      Chrome 46 y versiones posteriores

      Es 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

  • Promise<void>

    Chrome 96 y versiones posteriores

    Se resuelve cuando se completa la eliminación del token. Si la promesa no se rechaza, significa que el token se revocó correctamente.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getCreationTime()

Promise 
chrome.instanceID.getCreationTime(
  callback?: function,
): Promise<number>

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

Parámetros

  • callback

    función opcional

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

    (creationTime: number) => void

    • creationTime

      número

      Es la hora en que se generó el ID de instancia, expresada en milisegundos desde la época.

Muestra

  • Promise<number>

    Chrome 96 y versiones posteriores

    Se resuelve cuando se completa la recuperación.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getID()

Promise 
chrome.instanceID.getID(
  callback?: function,
): Promise<string>

Recupera un identificador para la instancia de la app. El ID de la instancia se devolverá con el callback. Se devolverá el mismo ID siempre que la identidad de la aplicación no se haya revocado ni 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

  • Promise<string>

    Chrome 96 y versiones posteriores

    Se resuelve cuando se completa la recuperación.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getToken()

Promise 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
): Promise<string>

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

Parámetros

  • getTokenParams

    objeto

    Son los parámetros de getToken.

    • authorizedEntity

      string

      Chrome 46 y versiones posteriores

      Identifica la entidad que tiene autorización 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

      ya no están disponibles 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 podrán usar en el procesamiento de la solicitud.

    • alcance

      string

      Chrome 46 y versiones posteriores

      Identifica las acciones autorizadas que puede realizar la entidad autorizada. Por ejemplo, para enviar mensajes de GCM, se debe usar el permiso GCM.

  • callback

    función opcional

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

    (token: string) => void

    • token

      string

      Es un token asignado por el servicio solicitado.

Muestra

  • Promise<string>

    Chrome 96 y versiones posteriores

    Se resuelve cuando se completa la recuperación.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

Eventos

onTokenRefresh

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

Se activa cuando se deben actualizar todos los tokens otorgados.

Parámetros

  • callback

    función

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

    () => void