İletileri arama ve filtreleme

Bu belgede, Gmail API kullanılarak iletilerin nasıl sorgulanacağı ve bulunacağı açıklanmaktadır.

Dosyaları messages.list ve threads.list yöntemlerini kullanarak arayabilir veya filtreleyebilirsiniz. Bu yöntemler, Gmail web arayüzüyle aynı gelişmiş arama söz diziminin çoğunu destekleyen q sorgu parametresini kabul eder. Gmail kullanıcı arayüzü ile Gmail API arasındaki arama ve filtre farklılıklarının listesi için Gmail kullanıcı arayüzünden farklılıklar başlıklı makaleyi inceleyin.

Bu gelişmiş arama söz dizimi, sorguları kullanarak iletileri gönderen, tarih veya etiket gibi özelliklere göre filtrelemenize olanak tanır. Örneğin, aşağıdaki messages.list yöntem sorgusu, kullanıcının Ocak 2014'te gönderdiği tüm iletileri alır:

GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01

Arama sorgularına ek olarak, labelIds[] parametresiyle mesajları ve ileti dizilerini etikete göre de filtreleyebilirsiniz. Bu sayede, belirtilen sistem veya kullanıcı etiketlerinin uygulandığı iletileri ve ileti dizilerini arayabilirsiniz. Daha fazla bilgi için messages.list ve threads.list yöntemlerine bakın. Etiketler hakkında daha fazla bilgi için Etiketleri yönetme başlıklı makaleyi inceleyin.

Gmail kullanıcı arayüzünden farklılıklar

Gmail API, Gmail kullanıcı arayüzünde kullanılan gelişmiş arama söz diziminin çoğunu desteklese de bazı farklılıklar vardır:

  • Gmail kullanıcı arayüzü, takma ad genişletme işlemi gerçekleştirir. Bu işlem, Google Workspace hesabından hesap takma adı çıkarılmasına olanak tanır. Örneğin, myprimary@cymbalgroup.com hesabınız olduğunu ve yöneticinizin bu hesap için myalias@cymbalgroup.com adında bir takma ad oluşturduğunu varsayalım. myalias@cymbalgroup.com bir e-posta gönderdiğinde ancak "from: myprimary@cymbalgroup.com" ifadesini aradığınızda myalias@cymbalgroup.com tarafından gönderilen e-posta, Gmail kullanıcı arayüzündeki arama sonuçlarında görünür ancak API yanıtında görünmez.

  • Gmail kullanıcı arayüzü, kullanıcıların ileti dizisi genelinde arama yapmasına olanak tanır ancak API bunu desteklemez.