chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Opis

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

Uprawnienia

gcm

Dostępność

Chrome 44 lub nowsza wersja

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

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Zostanie rozwiązany po zakończeniu usuwania. Jeśli obietnica nie zostanie odrzucona, identyfikator instancji został unieważniony.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

deleteToken()

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

Unieważnia przyznany token.

Parametry

  • deleteTokenParams

    obiekt

    Parametry metody deleteToken.

    • authorizedEntity

      tekst

      Chrome 46 lub nowsza wersja

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

    • zakres

      tekst

      Chrome 46 lub nowsza wersja

      Zakres używany do uzyskania tokena.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po zakończeniu usuwania tokena. Jeśli obietnica nie zostanie odrzucona, token został unieważniony.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getCreationTime()

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

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

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (creationTime: number) => void

    • creationTime

      liczba

      Czas wygenerowania identyfikatora instancji, wyrażony w milisekundach od początku epoki.

Zwroty

  • Promise<number>

    Chrome 96 lub nowsza wersja

    Rozwiązuje się po zakończeniu pobierania.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 unieważniona lub nie wygaśnie.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (instanceID: string) => void

    • instanceID

      tekst

      Identyfikator instancji przypisany do instancji aplikacji.

Zwroty

  • Promise<string>

    Chrome 96 lub nowsza wersja

    Rozwiązuje się po zakończeniu pobierania.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getToken()

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

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

Parametry

  • getTokenParams

    obiekt

    Parametry getToken.

    • authorizedEntity

      tekst

      Chrome 46 lub nowsza wersja

      Identyfikuje podmiot, który ma uprawnienia dostępu do zasobów powiązanych z tym identyfikatorem instancji. Może to być identyfikator projektu z konsoli Google Developers.

    • Opcje

      object opcjonalny

      Chrome 46 lub nowsza Wycofane od Chrome 89

      zostały wycofane i będą ignorowane.

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

    • zakres

      tekst

      Chrome 46 lub nowsza wersja

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (token: string) => void

    • token

      tekst

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

Zwroty

  • Promise<string>

    Chrome 96 lub nowsza wersja

    Rozwiązuje się po zakończeniu pobierania.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onTokenRefresh

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

Uruchamiane, gdy wszystkie przyznane tokeny muszą zostać odświeżone.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void