İstemcileri Gmail ile senkronize etme

Bu belgede, istemcilerin Gmail API ile nasıl senkronize edileceği açıklanmaktadır.

Çoğu uygulama senaryosunda istemcinizin Gmail ile senkronize kalması önemlidir. İki senkronizasyon yöntemi vardır: tam senkronizasyon ve kısmi senkronizasyon. İstemciniz Gmail'e ilk kez bağlandığında ve nadir durumlarda tam senkronizasyon yapmanız gerekir. Müşteriniz yakın zamanda senkronizasyon yaptıysa kısmi senkronizasyon, tam senkronizasyona göre daha az kaynak kullanan bir alternatiftir. Gereksiz yoklamayı önlemek için anlık bildirimleri kullanarak kısmi senkronizasyonu yalnızca gerektiğinde ve anlık olarak tetikleyebilirsiniz.

Tam senkronizasyon

Uygulamanız Gmail'e ilk kez bağlandığında veya kısmi senkronizasyon kullanılamadığında tam senkronizasyon yapmanız gerekir. Tam senkronizasyon işleminde uygulamanız, amacınız için gerekli olan en son iletileri veya ileti dizilerini alıp depolamalıdır. Örneğin, uygulamanızda son mesajların listesi gösteriliyorsa kullanıcının gösterilen ilk birkaç mesajın ötesine kaydırması durumunda duyarlı bir arayüz sağlamak için yeterli sayıda mesajı alıp önbelleğe kaydedebilirsiniz.

Tam senkronizasyon gerçekleştirmek için aşağıdaki adımları uygulayın:

  1. İleti kimliklerinin ilk sayfasını almak için messages.list yöntemini çağırın.

  2. Liste isteği tarafından döndürülen iletilerin her biri için toplu istek oluşturun. messages.get yöntem istekleri.

    Uygulamanız ileti içeriklerini gösteriyorsa uygulamanız bir iletiyi ilk kez aldığında format parametresini format=full veya format=raw olarak ayarlayın ve ek alma işlemlerini önlemek için sonuçları önbelleğe alın. Daha önce önbelleğe alınmış bir mesajı alıyorsanız yalnızca labelIds değişebileceğinden yanıtın boyutunu küçültmek için format=minimal kullanın.

  3. Güncellemeleri, önbelleğe alınmış sonuçlarınızla birleştirin. Uygulamanız, gelecekteki kısmi senkronizasyonlar için en son mesajın (list yanıtındaki ilk mesaj) historyId değerini saklamalıdır.

Kısmi senkronizasyon

Uygulamanız yakın zamanda senkronize edildiyse isteğinizde belirtmeniz gereken startHistoryId sorgu parametresinden daha yeni olan tüm geçmiş kayıtlarını döndürmek için history.list yöntemini kullanarak kısmi senkronizasyon gerçekleştirebilirsiniz.

startHistoryId sorgu parametresi, son mesajın historyId olarak ayarlanmalıdır. Son mesajın historyId değerini almak için messages.get veya messages.list yöntemlerini kullanın. Değeri, gelecekte kullanmak üzere tam veya kısmi senkronizasyon sırasında da ayarlayabilirsiniz.

Döndürülen History nesnesi, sağlanan startHistoryId zamanından itibaren ileti kimliklerini ve her ileti için değişiklik türünü (ör. ileti eklendi veya etiketler değiştirildi) içerir.

Sınırlamalar

Geçmiş kayıtları genellikle en az bir hafta, çoğu zaman da daha uzun süre kullanılabilir. Ancak kayıtların kullanılabildiği süre önemli ölçüde daha kısa olabilir ve nadir durumlarda kayıtlar kullanılamayabilir.

İstemciniz tarafından sağlanan startHistoryId, kullanılabilir geçmiş kayıtları aralığının dışındaysa Gmail API, HTTP 404 hata yanıtı döndürür. Bu durumda müşterinizin tam senkronizasyon gerçekleştirmesi gerekir.