chrome.gcm

refresh date: 2026-09-25 robots: noindex

Açıklama

Uygulamaların ve uzantıların Firebase Cloud Messaging (FCM) üzerinden mesaj göndermesini ve almasını sağlamak için chrome.gcm seçeneğini kullanın.

İzinler

gcm

Özellikler

MAX_MESSAGE_SIZE

Bir iletideki tüm anahtar/değer çiftlerinin maksimum boyutu (bayt cinsinden).

Değer

4096

Yöntemler

register()

Promise 
chrome.gcm.register(
  senderIds: string[],
  callback?: function,
): Promise<string>

Uygulamayı FCM'ye kaydeder. Kayıt kimliği, callback tarafından döndürülür. register aynı senderIds listesiyle tekrar çağrılırsa aynı kayıt kimliği döndürülür.

Parametreler

  • senderIds

    string[]

    Uygulamaya ileti göndermesine izin verilen sunucu kimliklerinin listesi. En az bir, en fazla 100 gönderen kimliği içermelidir.

  • callback

    işlev isteğe bağlı

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

    (registrationId: string) => void

    • registrationId

      dize

      FCM tarafından uygulamaya atanan kayıt kimliği.

İadeler

  • Promise<string>

    Chrome 116 veya daha yeni bir sürüm

    Kayıt tamamlandığında çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

send()

Promise 
chrome.gcm.send(
  message: object,
  callback?: function,
): Promise<string>

İçeriğine göre mesaj gönderir.

Parametreler

  • mesaj

    nesne

    FCM aracılığıyla diğer tarafa gönderilecek bir mesaj.

    • veri

      nesne

      Sunucuya gönderilecek ileti verileri. Büyük/küçük harfe duyarlı olmayan goog. ve google ile büyük/küçük harfe duyarlı olan collapse_key, anahtar önekleri olarak kullanılamaz. Tüm anahtar/değer çiftlerinin toplamı gcm.MAX_MESSAGE_SIZE değerini aşmamalıdır.

    • destinationId

      dize

      Mesajın gönderileceği sunucunun Google API Konsolu tarafından atanan kimliği.

    • messageId

      dize

      İletinin kimliği. Uygulamalar kapsamındaki her ileti için benzersiz olmalıdır. Kimlik seçme ve işleme konusunda tavsiye almak için Cloud Messaging belgelerini inceleyin.

    • timeToLive

      number isteğe bağlı

      İletinin saniye cinsinden TTL'si. İleti bu süre içinde gönderilemezse onSendError etkinliği tetiklenir. TTL değeri 0 ise iletinin hemen gönderilmesi veya mümkün değilse başarısız olması gerektiğini gösterir. Yaşam süresinin varsayılan değeri 86.400 saniye (1 gün), maksimum değeri ise 2.419.200 saniyedir (28 gün).

  • callback

    işlev isteğe bağlı

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

    (messageId: string) => void

    • messageId

      dize

      Geri arama isteğinin gönderildiği mesajın kimliği.

İadeler

  • Promise<string>

    Chrome 116 veya daha yeni bir sürüm

    İleti gönderme için başarıyla sıraya alındıktan sonra çözülür. Bir hata oluşursa söz reddedilir.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

unregister()

Promise 
chrome.gcm.unregister(
  callback?: function,
): Promise<void>

Uygulamanın FCM kaydını siler.

Parametreler

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 116 veya daha yeni bir sürüm

    Kaydı silme işlemi tamamlandıktan sonra çözülür. Söz reddedilmezse kayıt iptali başarılı olur.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onMessage

chrome.gcm.onMessage.addListener(
  callback: function,
)

FCM üzerinden bir mesaj alındığında tetiklenir.

Parametreler

  • callback

    işlev

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

    (message: object) => void

    • mesaj

      nesne

      • collapseKey

        dize isteğe bağlı

        Bir mesajın daraltma anahtarı. Ayrıntılar için Daraltılamayan ve daraltılabilen mesajlar bölümüne bakın.

      • veri

        nesne

        İleti verileri.

      • başlangıç fiyatı:

        dize isteğe bağlı

        Mesajı gönderen.

onMessagesDeleted

chrome.gcm.onMessagesDeleted.addListener(
  callback: function,
)

Bir FCM sunucusunun, uygulama sunucusu tarafından uygulamaya gönderilen iletileri silmesi gerektiğinde tetiklenir. Bu etkinliğin işlenmesiyle ilgili ayrıntılar için İletinin kullanım ömrü başlıklı makaleyi inceleyin.

Parametreler

  • callback

    işlev

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

    () => void

onSendError

chrome.gcm.onSendError.addListener(
  callback: function,
)

FCM sunucusuna mesaj gönderilemediğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (error: object) => void

    • hata

      nesne

      • ayrıntılar

        nesne

        Hatayla ilgili ek ayrıntılar (varsa).

      • errorMessage

        dize

        Sorunu açıklayan hata mesajı.

      • messageId

        dize isteğe bağlı

        Hata belirli bir mesajla ilgiliyse bu hatayı içeren mesajın kimliği.