Gmail API'sine genel bakış

Gmail API, Gmail posta kutularına erişmenize ve posta göndermenize olanak tanıyan bir RESTful API'dir. Gmail API, çoğu web uygulaması için 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 yetkili
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 Temsilcileri yönetme başlıklı makaleyi inceleyin.
Draft
Gönderilmemiş bir ileti. Taslakta yer alan mesajı değiştirebilirsiniz. Taslağın gönderilmesi, taslağı otomatik olarak siler ve SENT sistem etiketiyle bir ileti oluşturur. drafts kaynağı taslağı temsil eder. 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. Yönlendirme kuralında veya filtrede bir adresi kullanabilmeniz için sahipliği kanıtlamak üzere adresi kaydetmeniz ve doğrulamanız 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" etiketini oluşturup vergiyle ilgili tüm mesajlara ve ileti dizilerine uygulayabilirsiniz. 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 etiketleri silemez veya değiştiremezsiniz. Ancak, INBOX gibi bazı sistem etiketlerini iletilere ve ileti dizilerine uygulayabilir veya bu etiketleri iletilerden ve ileti dizilerinden kaldırabilirsiniz.
Kullanıcı etiketleri
Kullanıcı tarafından oluşturulan etiketler. Bu etiketler bir kullanıcı veya uygulama tarafından silinebilir ya da değiştirilebilir. labels kaynağı, bir kullanıcı etiketini temsil eder.
Mesaj

Gönderen, alıcılar, konu ve ileti gövdesini içeren bir e-posta iletisi. Oluşturduğunuz iletileri değiştiremezsiniz. messages kaynağı bir iletiyi temsil eder.

Push bildirimleri

Google Cloud Pub/Sub ile entegre olan bir sunucu tarafı bildirim sistemi. Uygulamalar bir posta kutusunu "izleyebilir" ve Gmail API, bir değişiklik olduğunda (ör. yeni bir e-posta geldiğinde) otomatik webhook'lar veya uyarılar gönderir. Bu sayede uygulamanızın sunucuyu güncellemeler için yoklaması gerekmez. Daha fazla bilgi için Push bildirimleri başlıklı makaleyi inceleyin.

S/MIME sertifikaları

Belirli "Farklı gönder" takma adlarına yüklenen dijital sertifikalar. Bu sertifikalar, iletilerin güvenliğini ve gönderenin kimliğini doğrulayarak şifrelenmiş ve dijital olarak imzalanmış e-postalar göndermenize olanak tanır. Daha fazla bilgi için S/MIME sertifikalarını yönetme başlıklı makaleyi inceleyin.

Farklı adreslerden 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. E-posta istemcilerinde, bir veya daha fazla alıcı bir iletiye kendi iletileriyle yanıt verdiğinde ileti dizisi oluşur. Daha fazla bilgi için İş parçacıklarını yönetme başlıklı makaleyi inceleyin.

  • Kimlik doğrulama ve yetkilendirme işlemlerini de içeren 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.