chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Описание

Используйте chrome.instanceID для доступа к сервису Instance ID.

Разрешения

gcm

Доступность

Chrome 44 и более поздних версий;

Методы

deleteID()

Promise

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

Сбрасывает идентификатор экземпляра приложения и отзывает все связанные с ним токены.

Параметры

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  () => void

Возвраты

• Promise<void>

  Chrome 96 и более поздних версий;

  Выполняется, когда удаление завершено. Если объект Promise не отклонен, значит идентификатор экземпляра успешно отозван.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

deleteToken()

Promise

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

Отзывает предоставленный токен.

Параметры

• deleteTokenParams

  Объект

  Параметры для deleteToken.

  • authorizedEntity

    string

    Chrome 46 и более поздних версий;

    Уполномоченное лицо, которое используется для получения токена.

  • область действия

    string

    Chrome 46 и более поздних версий;

    Область действия, которая используется для получения токена.

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  () => void

Возвраты

• Promise<void>

  Chrome 96 и более поздних версий;

  Разрешается, когда удаление токена завершено. Если объект Promise не отклонен, токен успешно отозван.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getCreationTime()

Promise

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

Возвращает время создания InstanceID. Время создания будет возвращено callback.

Параметры

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  (creationTime: number) => void

  • creationTime

    число

    Время создания идентификатора экземпляра в миллисекундах с начала отсчета.

Возвраты

• Promise<number>

  Chrome 96 и более поздних версий;

  Разрешается, когда извлечение завершено.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getID()

Promise

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

Получает идентификатор экземпляра приложения. Идентификатор экземпляра будет возвращен callback. Один и тот же идентификатор будет возвращаться до тех пор, пока идентификационные данные приложения не будут отозваны или не истечет срок их действия.

Параметры

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  (instanceID: string) => void

  • instanceID

    string

    Идентификатор экземпляра, назначенный экземпляру приложения.

Возвраты

• Promise<string>

  Chrome 96 и более поздних версий;

  Распознается, когда извлечение завершается.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getToken()

Promise

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

Возвращает токен, который позволяет уполномоченному лицу получить доступ к сервису, определенному областью действия.

Параметры

• getTokenParams

  Объект

  Параметры для getToken.

  • authorizedEntity

    string

    Chrome 46 и более поздних версий;

    Идентифицирует объект, которому разрешен доступ к ресурсам, связанным с этим идентификатором экземпляра. Это может быть идентификатор проекта из Google Developer Console.

  • Параметры

    Объект (необязательно)

    Chrome 46 и более поздних версий Поддержка прекращена в Chrome 89

    больше не поддерживаются и будут игнорироваться.

    Позволяет включить небольшое количество пар "ключ-значение", которые будут связаны с токеном и могут использоваться при обработке запроса.

  • область действия

    string

    Chrome 46 и более поздних версий;

    Определяет разрешенные действия, которые может выполнять уполномоченное лицо. Например, для отправки сообщений GCM следует использовать область действия GCM.

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  (token: string) => void

  • токен

    string

    Токен, назначенный запрашиваемым сервисом.

Возвраты

• Promise<string>

  Chrome 96 и более поздних версий;

  Разрешается, когда извлечение завершено.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

События

onTokenRefresh

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

Срабатывает, когда нужно обновить все предоставленные токены.

Параметры

• обратный вызов

  function

  Параметр callback выглядит следующим образом:

  () => void