Gmail API'sine genel bakış

Gmail API, Gmail posta kutularına erişmek ve posta göndermek için kullanılabilecek bir RESTful API'dir. Çoğu web uygulaması için Gmail API, kullanıcının Gmail verilerine yetkili erişim sağlamak üzere en iyi seçenektir ve aşağıdakiler gibi çeşitli uygulamalar için uygundur:

  • Salt okunur posta ayıklama, indeksleme ve yedekleme
  • Otomatik veya programatik mesaj gönderme
  • E-posta hesabı taşıma
  • İletilerin filtrelenmesi ve sıralanması dahil e-posta düzenleme
  • Kuruluş genelinde e-posta imzalarının standartlaştırılması

Sık kullanılan terimler

Bu API'de kullanılan yaygın terimlerin listesini aşağıda bulabilirsiniz:

Yetki veren ve yetki alan
Yetki veren, aynı Google Workspace kuruluşundaki başka bir kullanıcıya posta kutusu erişimi veren Gmail kullanıcısıdır. Bu erişimi alan kullanıcı, yetkili kullanıcıdır. Yetki verilmiş kullanıcılar, yetki veren kullanıcının hesabı adına iletileri okuyabilir, gönderebilir ve silebilir, ayrıca kişileri görüntüleyip ekleyebilir. Daha fazla bilgi için Yetki verilmiş kullanıcıları yönetme başlıklı makaleyi inceleyin.
Draft
Gönderilmemiş bir ileti. Taslakta yer alan bir ileti değiştirilebilir. Taslağın gönderilmesi, taslağı otomatik olarak siler ve SENT sistem etiketiyle bir ileti oluşturur. Taslak, drafts kaynağıyla gösterilir. Daha fazla bilgi için Taslaklarla çalışma başlıklı makaleyi inceleyin.
Filtreler
Gelen iletileri belirli eşleşme ölçütlerine (ör. gönderen, konu veya boyut) göre değerlendiren bir hesap için yapılandırılmış gelişmiş kurallar. Bir ileti eşleştiğinde filtreler, etiket ekleme veya kaldırma ya da e-postayı belirtilen bir adrese yönlendirme gibi işlemleri otomatik olarak tetikler. Daha fazla bilgi için Filtreleri yönetme başlıklı makaleyi inceleyin.
Yönlendirme adresleri
Kullanıcı hesabından otomatik olarak yönlendirilen iletileri alacak şekilde yapılandırılmış belirli ve doğrulanmış e-posta adresleri. Bir adresin yönlendirme kuralında veya filtrede kullanılabilmesi için resmi olarak kaydedilmesi ve sahipliği kanıtlamak üzere doğrulanması gerekir. Daha fazla bilgi için Yönlendirmeyi yönetme başlıklı makaleyi inceleyin.
Etiket

İletileri ve ileti dizilerini düzenleme mekanizması. Örneğin, "vergiler" etiketi oluşturulup kullanıcının vergileriyle ilgili tüm iletilere ve ileti dizilerine uygulanabilir. Daha fazla bilgi için Etiketleri yönetme başlıklı makaleyi inceleyin.

İki tür etiket vardır:

Sistem etiketleri
Dahili olarak oluşturulan etiketler (ör. INBOX, TRASH veya SPAM). Bu etiketler silinemez veya değiştirilemez. Ancak INBOX gibi bazı sistem etiketleri iletilere ve ileti dizilerine uygulanabilir veya bu etiketler iletilerden ve ileti dizilerinden kaldırılabilir.
Kullanıcı etiketleri
Kullanıcı tarafından oluşturulan etiketler. Bu etiketler kullanıcı veya bir uygulama tarafından silinebilir ya da değiştirilebilir. Kullanıcı etiketi, labels kaynağıyla temsil edilir.
Mesaj

Gönderen, alıcılar, konu ve ileti gövdesini içeren bir e-posta iletisi. Bir mesaj oluşturulduktan sonra değiştirilemez. İletiler, messages kaynağıyla temsil edilir.

Push bildirimleri

Google Cloud Pub/Sub ile entegre olan bir sunucu tarafı bildirim sistemi. Uygulamalar bir posta kutusunu "izleyebilir". Gmail API, değişiklik olduğunda (ör. yeni bir e-posta geldiğinde) otomatik webhook'lar veya uyarılar göndererek uygulamanın sunucuyu sürekli olarak güncelleme için yoklamasına gerek kalmaz. Daha fazla bilgi için Push bildirimleri konusuna bakın.

S/MIME sertifikaları

Kullanıcının şifrelenmiş ve dijital olarak imzalanmış e-postalar göndermesine olanak tanıyan, belirli "farklı gönder" takma adlarına yüklenen dijital sertifikalar. Bu sertifikalar, ileti güvenliğini ve gönderenin kimliğini doğrular. Daha fazla bilgi için S/MIME sertifikalarını yönetme başlıklı makaleyi inceleyin.

Farklı adresle gönderme takma adları

Bunlar, bir hesabın posta göndermeye yetkili olduğu çeşitli e-posta adreslerini gösterir. Her hesabın, birincil e-posta adresini temsil eden en az bir takma adı vardır. Diğer adlar, Gmail web arayüzündeki "Postayı şu adresten gönder" özelliğine karşılık gelir ve adres başına e-posta imzalarını yapılandırmak için de temel oluşturur. Daha fazla bilgi için Takma adları yönetme başlıklı makaleyi inceleyin.

Thread

Bir görüşme oluşturan ilgili mesajlar koleksiyonu. Bir e-posta istemcisi uygulamasında, bir veya daha fazla alıcı bir iletiye kendi iletisiyle yanıt verdiğinde ileti dizisi oluşturulur. Daha fazla bilgi için İş parçacıklarını yönetme başlıklı makaleyi inceleyin.

  • Kimlik doğrulama ve yetkilendirme işlemleri de dahil olmak üzere Google Workspace API'leriyle geliştirme hakkında bilgi edinmek için Google Workspace'te geliştirme başlıklı makaleyi inceleyin.

  • Gmail API uygulamasını nasıl yapılandıracağınızı ve çalıştıracağınızı öğrenmek için Hızlı Başlangıç Kılavuzları'nı inceleyin.