chrome.instanceID

Описание

Для доступа к службе идентификаторов экземпляров используйте chrome.instanceID .

Разрешения

gcm

Доступность

Chrome 44+

Методы

deleteID()

Обещать
chrome.instanceID.deleteID(
  callback?: function,
): Promise<void>

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

Параметры

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 96+

    Завершается после окончания процесса удаления. Идентификатор экземпляра был успешно отозван, если промис не был отклонен.

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

deleteToken()

Обещать
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
): Promise<void>

Отменяет выданный токен.

Параметры

  • deleteTokenParams

    объект

    Параметры для функции deleteToken.

    • авторизованная организация

      нить

      Chrome 46+

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

    • объем

      нить

      Chrome 46+

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 96+

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

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getCreationTime()

Обещать
chrome.instanceID.getCreationTime(
  callback?: function,
): Promise<number>

Получает время генерации InstanceID. Время создания будет возвращено функцией callback .

Параметры

  • перезвонить

    функция необязательна

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

    (creationTime: number) => void

    • creationTime

      число

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

Возвраты

  • Обещание<число>

    Chrome 96+

    Проблема решается после завершения процесса получения данных.

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getID()

Обещать
chrome.instanceID.getID(
  callback?: function,
): Promise<string>

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

Параметры

  • перезвонить

    функция необязательна

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

    (instanceID: string) => void

    • instanceID

      нить

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

Возвраты

  • Promise<string>

    Chrome 96+

    Проблема решается после завершения процесса получения данных.

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getToken()

Обещать
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
): Promise<string>

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

Параметры

  • getTokenParams

    объект

    Параметры для функции getToken.

    • авторизованная организация

      нить

      Chrome 46+

      Определяет сущность, уполномоченную получать доступ к ресурсам, связанным с этим идентификатором экземпляра. Это может быть идентификатор проекта из консоли разработчика Google .

    • параметры

      объект необязательный

      Chrome 46+ Устарело с версии Chrome 89

      Эти параметры устарели и будут игнорироваться.

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

    • объем

      нить

      Chrome 46+

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

  • перезвонить

    функция необязательна

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

    (token: string) => void

    • токен

      нить

      Токен, присвоенный запрошенной службой.

Возвраты

  • Promise<string>

    Chrome 96+

    Проблема решается после завершения процесса получения данных.

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

События

onTokenRefresh

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

Событие срабатывает, когда необходимо обновить все выданные токены.

Параметры

  • перезвонить

    функция

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

    () => void