chrome.instanceID

Opis

Aby uzyskać dostęp do usługi identyfikatora instancji, użyj nazwy chrome.instanceID.

Uprawnienia

gcm

Dostępność

Chrome 44 lub nowszy

Metody

deleteID()

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

Resetuje identyfikator instancji aplikacji i unieważnia wszystkie powiązane z nim tokeny.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome w wersji 96 lub nowszej

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

deleteToken()

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

Unieważnia przyznany token.

Parametry

  • deleteTokenParams

    obiekt

    Parametry funkcji deleteToken.

    • authorizedEntity

      ciąg znaków

      Chrome 46 lub nowsza

      Autoryzowany podmiot, który jest używany do uzyskania tokena.

    • zakres

      ciąg znaków

      Chrome 46 lub nowsza

      Zakres używany do uzyskania tokena.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome w wersji 96 lub nowszej

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getCreationTime()

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

Pobiera czas wygenerowania identyfikatora instancji. Czas utworzenia zostanie zwrócony przez callback.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (creationTime: number) => void

    • creationTime

      liczba

      Czas wygenerowania identyfikatora instancji podany w milisekundach od początku epoki.

Zwroty

  • Promise<number>

    Chrome w wersji 96 lub nowszej

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getID()

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

Pobiera identyfikator instancji aplikacji. Identyfikator instancji zostanie zwrócony przez callback. Ten sam identyfikator będzie zwracany, dopóki tożsamość aplikacji nie zostanie cofnięta lub nie wygaśnie.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (instanceID: string) => void

    • instanceID

      ciąg znaków

      Identyfikator instancji przypisany do instancji aplikacji.

Zwroty

  • Promise<string>

    Chrome w wersji 96 lub nowszej

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getToken()

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

Zwraca token, który umożliwia autoryzowanemu podmiotowi dostęp do usługi określonej przez zakres.

Parametry

  • getTokenParams

    obiekt

    Parametry funkcji getToken.

    • authorizedEntity

      ciąg znaków

      Chrome 46 lub nowsza

      Określa podmiot uprawniony do uzyskiwania dostępu do zasobów powiązanych z tym identyfikatorem instancji. Może to być identyfikator projektu z konsoli deweloperów Google.

    • Opcje

      obiekt opcjonalny

      Chrome 46 i nowsze Wycofane w Chrome 89

      zostały wycofane i będą ignorowane.

      Umożliwia dołączenie niewielkiej liczby par klucz-wartość w formie ciągów znaków, które będą powiązane z tokenem i mogą być używane podczas przetwarzania żądania.

    • zakres

      ciąg znaków

      Chrome 46 lub nowsza

      Określa autoryzowane działania, które może podjąć autoryzowany podmiot. Na przykład do wysyłania wiadomości GCM należy użyć zakresu GCM.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (token: string) => void

    • token

      ciąg znaków

      Token przypisany przez żądaną usługę.

Zwroty

  • Promise<string>

    Chrome w wersji 96 lub nowszej

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onTokenRefresh

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

Wysyłane, gdy wszystkie przyznane tokeny wymagają odświeżenia.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void