chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Açıklama

Örnek Kimliği hizmetine erişmek için chrome.instanceID kullanın.

İzinler

gcm

Kullanılabilirlik

Chrome 44+

Yöntemler

deleteID()

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

Uygulama örneği tanımlayıcısını sıfırlar ve onunla ilişkili tüm jetonları iptal eder.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Silme işlemi tamamlandığında çözümlenir. Promise reddedilmezse örnek tanımlayıcı başarıyla iptal edilmiştir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

deleteToken()

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

Verilen jetonu iptal eder.

Parametreler

  • deleteTokenParams

    nesne

    deleteToken için parametreler.

    • authorizedEntity

      dize

      Chrome 46+

      Jetonu almak için kullanılan yetkili tüzel kişi.

    • kapsam

      dize

      Chrome 46+

      Jetonu almak için kullanılan kapsam.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Jeton silme işlemi tamamlandığında çözümlenir. Promise reddedilmezse jeton başarıyla iptal edilmiştir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getCreationTime()

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

InstanceID'nin oluşturulduğu zamanı alır. Oluşturma zamanı callback tarafından döndürülür.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (creationTime: number) => void

    • creationTime

      sayı

      Örnek kimliğinin oluşturulduğu zaman, epoch'tan bu yana geçen milisaniye cinsinden gösterilir.

İadeler

  • Promise<number>

    Chrome 96+

    Alma işlemi tamamlandığında çözümlenir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getID()

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

Uygulama örneği için bir tanımlayıcı alır. Örnek kimliği callback tarafından döndürülür. Uygulama kimliği iptal edilmediği veya süresi dolmadığı sürece aynı kimlik döndürülür.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (instanceID: string) => void

    • instanceID

      dize

      Uygulama örneğine atanan örnek kimliği.

İadeler

  • Promise<string>

    Chrome 96+

    Alma işlemi tamamlandığında çözümlenir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getToken()

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

Yetkili tüzel kişinin, kapsam tarafından tanımlanan hizmete erişmesine olanak tanıyan bir jeton döndürür.

Parametreler

  • getTokenParams

    nesne

    getToken parametreleri.

    • authorizedEntity

      dize

      Chrome 46+

      Bu örnek kimliğiyle ilişkili kaynaklara erişme yetkisi olan tüzel kişiyi tanımlar. Google Developer Console'daki bir proje kimliği olabilir.

    • seçenekler

      isteğe bağlı nesne

      Chrome 46 ve sonraki sürümler Chrome 89'dan itibaren desteği sonlandırıldı

      seçeneklerinin desteği sonlandırılmıştır ve bu seçenekler yoksayılacaktır.

      Jetonla ilişkilendirilecek ve isteği işlemek için kullanılabilecek az sayıda dize anahtar/değer çifti eklenmesine olanak tanır.

    • kapsam

      dize

      Chrome 46+

      Yetkili tüzel kişinin gerçekleştirebileceği yetkili işlemleri tanımlar. Örneğin, GCM mesajları göndermek için GCM kapsamı kullanılmalıdır.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (token: string) => void

    • token

      dize

      İstenen hizmet tarafından atanan jeton.

İadeler

  • Promise<string>

    Chrome 96+

    Alma işlemi tamamlandığında çözümlenir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onTokenRefresh

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

Verilen tüm jetonların yenilenmesi gerektiğinde tetiklenir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    () => void