LinkedIn
Instagram
Telgraf
Slack Topluluğuna KatılınGmail API ile e-posta gönderme (5 satır kodla)
npm install unipile-node-sdkUNIPILE_DSN ve UNIPILE_TOKEN sana .env dosya.client.email.gönder()account_id, için, konuve vücut. Tamamlandı.takip_kimliği Gmail API aracılığıyla teslimatı onaylama.İthalat { UnipileClient } itibaren 'unipile-node-sdk';const müşteri = yeni UnipileClientSüreç.env.UNIPILE_DSN,
process.env.UNIPILE_TOKEN);const sonuç = bekle client.email.gönderaccount_id: 'acc_xxxxxxxxxxxxxxxx',
kime: [{
görünen_ad: 'Alice Martin',
tanımlayıcı: 'alice@acme.com'}],
konu: 'Gmail API'den Merhaba',
gövde: 'Unipile aracılığıyla gönderildi!'});konsol.log(sonuç); // { takip_kimliği: 'msg_...' }
Gmail API E-posta Gönder,
Python ve Node.js
Kod Örnekleri
Gmail API'yi Kullanarak Programatik Olarak E-posta Göndermeye İlişkin Kapsamlı Bir Geliştirici Kılavuzu: OAuth 2.0 Kurulumu, Kod Örnekleri, Hız Sınırları ve SMTP Karşılaştırması.
# Gmail API ile e-posta gönder
İthalat base64
itibaren email.mime.text İthalat MIMEText
itibaren googleapiclient.discovery İthalat inşa etmek
fonksiyon e-posta gönder(hizmet, ile, konu, gövde):
msg = MIMEText(gövde)
mesaj['için'] = için
mesaj['konu'] = özne
ham = base64.urlsafe_b64encode(
msg.byte dizisi olarak
).decode()
return service.users().messages().gönder(
kullaniciId='ben',
gövde={'çiğ'ham
).çalıştır()
Gmail API
Gmail API E-posta Gönderme nedir?
Gmail API aracılığıyla e-posta göndermek, Gmail'in arka uç sistemleriyle etkileşim kurmak için HTTP isteklerini kullanmayı içerir. Geliştiriciler, Gmail arayüzü aracılığıyla e-postaları manuel olarak oluşturup göndermek yerine bu süreci kendi uygulamaları içinde otomatikleştirebilirler.
API, geliştiricilerin düz metin, HTML ve ekli e-postalar dahil olmak üzere çeşitli formatlarda e-posta mesajları oluşturmasına ve göndermesine olanak tanıyan uç noktalar sağlar. Ayrıca, programlı e-posta iletişimi için kapsamlı bir çözüm sunarak iş parçacığı oluşturma ve e-posta etiketlerini yönetme gibi daha gelişmiş özellikleri de destekler. Çoklu sağlayıcı (Gmail, Outlook, IMAP) gönderme için Birleştirilmiş e-posta gönderme API kılavuzu. Bir çapraz sağlayıcı yaklaşımı için, şunu keşfedin e-posta gönderme API'si.
michel@company.com
E-posta Göndermek için Neden Gmail API Kullanılmalı?
Gmail API'yi e-posta göndermek için kullanmak, onu modern uygulamalar için güçlü bir seçim haline getiren çeşitli avantajlar sunar.
Otomasyon
E-posta görevlerinizi otomatikleştirin, zamandan tasarruf edin ve tüm iş akışınızda manuel hataları azaltın.
Entegrasyon
E-posta göndermeyi doğrudan uygulamanızın iş akışına entegre ederek, sorunsuz bir akışla kullanıcı deneyimini geliştirin.
Özelleştirme
Gerçekten kişiselleştirilmiş mesajlaşma için kullanıcı verilerine veya uygulama durumuna göre e-posta içeriğini dinamik olarak özelleştirin.
Ölçeklenebilirlik
Yüksek hacimli e-posta gönderimini verimli bir şekilde yönetin, büyük ölçekli iletişim gerektiren uygulamalar için idealdir.
E-posta Göndermek için Gmail API'sini Kurma
Google OAuth BelgeleriGoogle, üçüncü taraf uygulamaların Google kullanıcı verileri kullanımının doğrulanması için uygulamalarını göndermelerini zorunlu kılar. Takip et Aşağıda 10 adım OAuth'u yapılandırmak, Gmail API'yi etkinleştirmek ve üretim için kimlik bilgilerini hazırlamak. Ayrıca bakınız: E-posta API entegrasyonunuzu güvence altına alma.
Google Geliştirici Konsolu'na Erişin
Giriş yapın Google Developers Console Projenizin kurulumuna başlamak için yönetici ayrıcalıklarına sahip bir Google hesabına ihtiyacınız olacak.
Yeni bir Google Projesi Oluştur
Kaydolun Google Developers Console ve yeni bir proje oluşturun ya da mevcut bir Google projesini kullanın. Tıklayın YENİ PROJE Başlamak için proje seçiciyi kullanın.
OAuth İstemci Kimlik Bilgileri Oluştur
Git API'ler ve Hizmetler > Kimlik Bilgileri, sonra tıklayın HESAP BİLGİLERİ OLUŞTUR > OAuth istemci kimliği.
- Uygulama türü: Web uygulaması
- İsim: Dahili adınız
- Ekle 2 Yetkili yönlendirme URI'si Unipile DSN'inizi kullanarak (mevcut) Unipile Gösterge Tablosu):
https://{{YOUR_DSN_less_port}}/api/v1/hosted/google_auth_request_callback/port{{YOUR_PORT}}
Oluşturulduktan sonra, İstemci Kimliği ve İstemci Sırrı için Unipile Gösterge Tablosu > Ayarlar > Google OAuth.
Gmail API Kitaplığını Etkinleştir
Git API'ler ve Hizmetler > Kütüphane, ara, bul Gmail API, ve tıkla ETKİNLEŞTİR.
OAuth Onay Ekranı, Kullanıcı Türü Yapılandırması
Test aşamanıza göre Kullanıcı Türünüzü seçin:
- Dahili: Kuruluşunuzdaki yalnızca Google Workspace kullanıcılarıyla sınırlı.
- Harici ve Test Aşamasında: Test Kullanıcıları Eklemesi Gerekiyor. Tokenlar 7 gün içinde geçerliliğini yitirir.
Kullanıcı Türleri hakkında daha fazla bilgi için, bkz. Google dokümantasyonları.
Uygulama Bilgilerini Doldurun
OAuth onay ekranında aşağıdakileri sağlayın:
- Uygulama Adı: Uygulamanızın görünen adı.
- Kullanıcı Desteği E-postası: Kullanıcı soruları için bir iletişim e-postası veya dağıtım listesi.
- Uygulama Logosu Görsel tanımlama için uygulama logonuzu yükleyin.
Uygulama Alanı Bilgilerini Ayarla
- Uygulama Ana Sayfa URL'si: Gerçek bir ana sayfa, sadece bir giriş sayfası değil.
- Gizlilik Politikası Bağlantısı: Buna emin ol Google'ın özel gereksinimleri, özellikle Sınırlı Kullanım bölümüne.
- Hizmet Şartları Bağlantısı: Genel hizmet şartları URL'si.
Yetkilendirilmiş Alanlar Ekle
- Üretim uygulama alan adınızı ekleyin (dev veya staging alan adını değil).
- Ekle unipile.com ikinci yetkili alan olarak.
Geliştirici İletişim Bilgilerini Girin
Doğrulama bildirimleri için Google'ın kullanabileceği bir e-posta adresi sağlayın. İlgili tüm ekip üyelerinin güncellemeleri alması için bir dağıtım listesi kullanın. Google'ın e-postaları spam klasörlerine düşebileceğinden düzenli olarak izleyin.
Gerekli Kapsamları Ekle
Tıkla KAPSAMLARI EKLE VEYA KALDIR ve aşağıdakileri ekleyin (görünmezlerse sayfayı yenileyin):
Not: gmail.değiştir Yalnızca e-postaları taşımak veya silmek istiyorsanız gereklidir. Kullanmıyorsanız, hesabınızdan manuel olarak kaldırmak için Unipile desteğiyle iletişime geçin.
11
Gösteri Videonuzu Oluşturun
Yapınız tamamen canlıya alındığında yalnızca bir kez gerekir
Google'ın şartlarına uyan bir deneme videosu hazırlayın ve barındırın. Bunu şuraya yükleyin: Listelenmemiş YouTube videosu, Yalnızca bir video bağlantısına izin verilir.
- Uygulamanız ve OAuth akışı, Google belgelerinde belirtildiği gibi İngilizce olarak sunulmaktadır.
- Gösterim, üretim düzeyinde bir etki alanında gerçekleştirilmiştir.
- Google Proje ayarlarında, onayla Yayın durumu "Yapım Aşamasında" ve Kullanıcı Türü Dış.
- Uygulamanızın ana sayfasını tam URL'si ile görüntüleyin.
- Google Müşterimiz Hesabını Resmi Google Giriş Düğmesiyle Nasıl Bağlayabilir Bu, Google'la oturum açma özelliğini kullanarak Google hesabınızı bir uygulamaya veya web sitesine nasıl bağlayabileceğinizi gösteren bir kılavuz ve örnektir. **Adım 1: Oturum Açma Düğmesini Bulun** Bir web sitesinde veya uygulamada oturum açma sayfasında genellikle "Google ile Oturum Aç" veya "Google ile Devam Et" gibi etiketlenmiş bir düğme arayın. Bu düğme, Google'ın standart tasarımına uygun, genellikle renkli bir Google logosu içerir. **Adım 2: Düğmeye Tıklayın** İstediğiniz düğmeyi bulduğunuzda, tıklayın. Bu sizi Google'ın güvenli oturum açma sayfasına yönlendirecektir. **Adım 3: Google Hesabınızı Seçin (Gerekirse)** Eğer bilgisayarınızda veya cihazınızda zaten birden fazla Google hesabında oturum açmışsanız, Google size oturum açmak istediğiniz hesabı seçmeniz için bir istem gösterecektir. Hesabınızı seçin. **Adım 4: İzinleri Gözden Geçirin ve Onaylayın** Google, uygulamaya veya web sitesine hangi bilgileri paylaşacağınıza dair bir ekran gösterecektir. Bu genellikle adınız, e-posta adresiniz ve profil resminiz gibi temel bilgilerdir. Uygulamanın ne kadar erişim istediğini dikkatlice gözden geçirin. Kabul ediyorsanız, "İzin Ver" veya "Kabul Et" düğmesine tıklayın. **Adım 5: Oturum Açma Tamamlandı** İzinleri verdikten sonra, Google sizi orijinal uygulamaya veya web sitesine geri yönlendirecektir. Artık Google hesabınızla başarılı bir şekilde oturum açmış olmalısınız ve devam edebilirsiniz. **Örnek Senaryo:** Diyelim ki yeni bir fotoğraf düzenleme uygulaması indirdiniz. Uygulamayı ilk kez açtığınızda, size oturum açmanızı veya bir hesap oluşturmanızı soracaktır. 1. Uygulamada büyük, genellikle mavi renkte bir "Google ile Oturum Aç" düğmesi görürsünüz. 2. Bu düğmeye tıklarsınız. 3. Cihazınızdaki Google hesabınızdan bir hesap seçmeniz istenir (eğer birden fazla hesabınız varsa). 4. Google, fotoğraf düzenleme uygulamasının adını ve temel profil bilgilerinize erişme izni istediğini gösteren bir mesaj görüntüler. 5. "Devam Et"e tıklarsınız. 6. Uygulamaya geri dönersiniz ve artık oturum açmışsınızdır. Ek bilgilerinizi girmenize veya yeni bir şifre oluşturmanıza gerek kalmadı. Bu yöntem, verilerinizi korurken uygulamalara ve web sitelerine güvenli ve hızlı bir şekilde erişmenin kolay bir yoludur.
- OAuth akışı sırasında, URL'yi vurgulayın ve şunu gösterin: MÜŞTERİ KİMLİĞİ.
- Talep edilen her bir kapsamı sıralı olarak, özel kullanım durumunuza göre uyarlanmış bir şekilde sergileyin.
- Uygulamanızın Gmail ile senkronizasyonunu göstererek çift yönlü işlevselliği sergileyin (gönderme, alma ve Gönderilmiş e-postalar listesi güncellemeleri).
- Son videoyu, listelenmemiş bir YouTube videosu bağlantısı olarak Google Projenize ekleyin.
- YouTube URL'sini incelemesi için Müşteri Başarı Yöneticinize gönderin.
- Gözden geçirdikten sonra, uygulama doğrulama gönderimiyle devam edin.
Zaman çizelgesi: doğrulama şu kadar sürebilir: 2 ila 8 hafta Google'ın kuyruğuna ve düzeltme turlarının sayısına bağlı olarak.
12
Kısıtlı Kapsamlar İçin Beyaz Liste Oluşturma ve Güvenlik İncelemesi
Yalnızca uygulamanız kısıtlanmış kapsamları kullanıyorsa geçerlidir
Uygulamanız kısıtlı kapsamlar kullanıyorsa, ek adımlar gereklidir.
Kısıtlı kapsamdaki Google kullanıcı verilerine erişim isteyen uygulamalar, güvenlik değerlendirmesinden geçmelidir CASA (Bulut Uygulama Güvenliği Değerlendirmesi) program. Google, uygulamanızı 2. veya 3. Kademe olarak kategorize eder.
Kısıtlı kapsamları erişen uygulamaların güvenlik değerlendirmesini tamamlaması gerekir her 12 ayda bir erişimi sürdürmek için. Daha önce onaylanmamış yeni bir kısıtlı kapsam tanıtırsanız, uygulamanızın yeniden değerlendirilmesi gerekebilir.
Google'ın inceleme ekibi e-posta yoluyla iletişime geçecektir. Kendinizi hazır tutun. Proje Sahibi ve Proje Editörü Cloud Konsolu'nda bilgileri güncel tutun, böylece doğru ekip üyeleri bu bildirimleri alır.
Standart güvenlik incelemesine bir alternatif olarak, uygulamanız beyaz listeye alınabilir. Bu, olağan prosedürleri atlar ancak yalnızca uygulamanız çok özel kriterleri karşılıyorsa geçerlidir:
- Müşterilerin çoğunluğu Google Workspace kullanıyor: çoğu müşterinin e-postalarının @şirket.com formatında olması gerekir.
- Yönetici tarafından başlatılan beyaz listeye alma: Son kullanıcılarınızın yöneticileri, kendi Yönetici Konsolu'nuz aracılığıyla Google İstemci Kimliğiniz üzerinden erişime izin verir.
- Sınırlı Kişisel Gmail Kullanımı: 100'den az kişisel Gmail hesabı (@gmail.com) kimlik doğrulamalıdır.
- Doğrulanmamış projelerin 100 ömür boyu kullanıcı sınırı vardır. Çalışma alanı hesapları bu sınıra dahil değildir, ancak kişisel Gmail hesapları her zaman dahildir.
- Ücretsiz deneme kullanıcıları Workspace e-posta adreslerini kullanmalı ve uygulamayı beyaz listeye eklemelidir.
Beyaz listeleme geçici bir çözümdür ve tüm kullanım durumları için uygun olmayabilir. Bu yola gitmeden önce kriterleri dikkatlice değerlendirin.
CRM, ATS, Outreach ve iPaaS için Gmail API'si
E-posta gönderimini otomatikleştirin, konuşmaları senkronize edin ve her tür B2B SaaS platformunda müşteri iletişimini merkezileştirin.
CRM'inizden ayrılmadan e-postaları kaydedip gönderin
E-posta iletişimini otomatikleştirin, etkileşimleri izleyin ve müşteri etkileşimini geliştirin. Müşteri e-postalarını kaydedin, kişiselleştirilmiş mesajlar gönderin ve tüm konuşmaları işlem hattınızda merkezileştirin.
Gmail
Adaylara tek bir birleşik gelen kutusundan e-posta gönderin
Aday iletişimi kolaylaştırın, mülakatları planlayın ve işe alım platformunuzdan doğrudan teklif mektupları gönderin. Her yanıt otomatik olarak doğru aday profiline eklenir.
Mülakat daveti, Kıdemli Mühendis pozisyonu
GÖNDERİLDİ
E-posta dizilerini büyük ölçekte güçlendirin
Gmail'i ana e-posta motoru olarak kullanarak çok kanallı diziler oluşturun. Kişiselleştirilmiş mesajlar gönderin, açılmaları ve yanıtları izleyin ve potansiyel müşterinin davranışına göre takip e-postalarını tetikleyin.
Herhangi bir iş akışında Gmail eylemlerini tetikleyin
Gmail'in e-posta gönderme yeteneklerini otomasyon oluşturucularına gömün. Son kullanıcıların, OAuth akışını sıfırdan oluşturmadan, Gmail hesaplarını bağlamasına ve çok adımlı iş akışlarının bir parçası olarak e-posta göndermesini tetiklemesine olanak tanıyın.
Gmail API E-posta Gönderme Temel Özellikleri
E-postaları al, yeni mesajlar oluştur ve gönder, etiketleri yönet ve gerçek zamanlı webhook bildirimleri al. Uygulamanızdaki her e-posta iş akışını kapsayan dört temel yetenek.
Tüm E-postaları Listele
Kullanıcının Gmail hesabındaki e-postaları alıp görüntüleyin. Güçlü arama ve yönetim için klasöre, tarihe, gönderene veya okunmuş olup olmamasına göre filtreleyin.
E-posta Listeleme ÖzelliğiYeni E-posta Gönder
Uygulamanızdan programatik olarak e-posta oluşturun ve gönderin. HTML, düz metin, ekler, CC, BCC ve ileti dizisi yanıtlarını destekleyin.
E-posta Gönderme ÖzelliğiEtiketleri Listele ve Al
Gmail etiketlerini ve klasörlerini, bireysel etiket ayrıntılarını listeleyerek veya alarak yönetin. Daha akıllı iş akışı yönlendirmesi için e-postaları düzenleyin ve kategorilere ayırın.
Etiket Listeleme ve AlmaWebhook Takibi
E-posta etkinliği hakkında gerçek zamanlı güncellemeler almak için webhook'lar ayarlayın. Yeni mesajlar, açmalar, yanıtlar veya geri dönüşler üzerine anında tetikleyiciler oluşturun.
Webhook Bildirimi
Gmail API Uç Noktaları
Gmail API ile yapabileceğiniz her şey
Unipile üzerinden erişilebilen Gmail uç noktalarına, hesap bağlantısından webhook takibine kadar eksiksiz bir genel bakış.
Gmail API ile E-posta Gönderme
Gmail API üzerinden düz metin, HTML ve ekli e-postalar göndermek için eksiksiz Python ve Node.js örnekleri. OAuth 2.0 kimlik doğrulama dahil, kopyala-yapıştır'a hazır.
1 Düz Metin E-posta Gönderin (Python)
Resmi olanı kullan google-api-python-client ve google-kimlikdoğrulama kütüphaneleri. Fonksiyon, bir MIME mesajı oluşturur, bunu base64url ile kodlar ve Gmail API gönder uç noktasına gönderir.
İthalat base64 itibaren email.mime.text İthalat MIMEText itibaren google.oauth2.kimlik bilgileri İthalat Kimlik Bilgileri itibaren googleapiclient.discovery İthalat inşa etmek fonksiyon e-posta gönder(alıcı, konu, gövde, kimlik_bilgileri_sözlüğü): kimlik_bilgileri = Kimlik Bilgileri(**credentials_dict) servis = inşa etmek('gmail', 'v1', credentials=creds) mesaj = MIMEText(vücut) mesaj['için'] = için mesaj['konu'] = konu hilal = taban64.urlsafe_b64encode(mesaj).baytları_al()).çöz() sonuç = servis.kullanıcılar().mesajlar().gönderuserId='ben', gövde={'çiğ'}: ham} ).yürüt() print(f"Mesaj gönderildi. ID: {result['id']}") return sonuç # Kullanım e-posta gönderkime='recipient@example.com', konu='Gmail API'den Merhaba', gövde='Bu e-posta Gmail API aracılığıyla gönderildi.', kimlik_bilgileri_sözlüğü={ 'belirteç': 'SENİN_ERİŞİM_TOKENIN', 'yenileme_belirteci': 'YENİLEME_DAHİLİ_KODUNUZ', 'istemci_kimliği': 'SENİN_MÜŞTERİNOID', 'client_secret': 'MÜŞTERİ_GİZLİ_ANAHTARINIZ', 'token_uri': 'https://oauth2.googleapis.com/token' } )
2 Düz Metin E-posta Gönder (Node.js)
Kullanın googleapis npm paketi. Mesaj, base64url ile kodlanmış ham bir RFC 2822 dizesi olarak oluşturulur ve Gmail API'si aracılığıyla gönderilir.
const { google } require('googleapis'); async function ePosta gönder(kimlik doğrulama, kime, konu, gövde) { const gmail = google.gmail({ sürüm: 'v1', auth }); const mesaj = [ `Kime: ${to}`, Konu: ${subject}, '', gövde ].katıl('\n'); const şifrelenmişMesaj = Tampon.itibaren(mesaj) .toString('base64') .değiştir(/\+/g, '-') .değiştir(/\//gh, '_') .değiştir(/=+$/, ''); const sonuç = bekliyor gmail.users.messages.gönderkullanıcıId: 'ben', requestBody: { raw: encodedMessage } }); console.log(Mesaj gönderildi. ID: ${result.data.id}); return sonuç.veri; } // OAuth2 kurulumu const oauth2Client = yeni google.yetki.OAuth2( 'SENİN_MÜŞTERİNOID', 'MÜŞTERİ_GİZLİ_ANAHTARINIZ', 'YÖNLENDİRME_URI'NİZ' ); oauth2Müşteri.kimlik bilgilerini ayarlaerişim_anahtarı: 'SENİN_ERİŞİM_TOKENIN', yenileme_belirteci: 'YENİLEME_DAHİLİ_KODUNUZ' }); ePosta gönder(oauth2İstemci, 'recipient@example.com', 'Merhaba', 'Gmail API üzerinden gönderildi, e-posta gönder!');
3 HTML E-posta Gönder (Python)
Kullanım MIMEMultipart('alternatif') her ikisiyle de metin/düz yedekleme ve bir text/html Gmail istemcileri HTML sürümünü işleyecek, diğer istemciler ise düz metne dönecektir.
itibaren email.mime.multipart İthalat MIMEMultipart itibaren email.mime.text İthalat MIMEText İthalat base64 fonksiyon html_e-posta_gönder(servis, alıcı, konu, html_gövdesi): mesaj = MIMEMultipart('alternatif') mesaj['için'] = için mesaj['konu'] = özne # Düz metin yedeklemesi metin_parçası = MIMEText('Lütfen bu e-postayı HTML uyumlu bir istemcide görüntüleyin.', 'düz') # HTML sürümü html_parçası = MIMEText(html_gövde, 'html'mesaj.eklemekmesaj.eklemek(html_part) ham = base64.urlsafe_b64encode(mesaj).baytları_al()).çöz() return hizmet.kullanıcılar().mesajlar().gönderuserId='ben', gövde={'çiğ'}: ham} ).yürüt() # Kullanım html_içeriği = """Merhaba!
Bu e-posta ile gönderildi Gmail API e-posta gönder.
""" html_e-posta_gönderhizmet, 'to@example.com', 'Gmail API ile HTML E-posta', html_içeriği)
4 Ekli E-posta Gönder (Python)
Herhangi bir dosya türünü dosya baytlarını okuyarak, MIME türünü tahmin ederek ve ona ekleyerek ekleme MIMEMultipart Maksimum ek boyutu mesaj başına 25 MB'dır.
İthalat base64 İthalat MIME türleri itibaren email.mime.multipart İthalat MIMEMultipart itibaren email.mime.text İthalat MIMEText itibaren email.mime.taban İthalat MIMEBase itibaren e-posta İthalat kodlayıcılar fonksiyon ekli e-posta gönder(servis, kime, konu, gövde, dosya_yolu): mesaj = MIMEMultipart() mesaj['için'] = için mesaj['konu'] = konu mesaj.eklemek(MIMETextvücut, 'düz')) # MIME türünü algıla ve dosyayı ekle content_type, encoding = mimetypes.tahmin_tipi(dosya_yolu) ana_tip, alt_tip = içerik_tipi.bölmek('/', 1) ile aç(dosya_yolu, 'rb') olarak f: ek = MIMEBase(ana_tip, alt_tip) ek.yükleme_ayarla(f.oku() kodlayıcılar.base64_kodlaek.başlık_ekle( 'İçerik-Ayerlanma', f'attachment; filename="{dosya_yolu.split("/")[-1]}"' ) mesaj.eklemekindirilen = base64.urlsafe_b64encode(mesaj).baytları_al()).çöz() return hizmet.kullanıcılar().mesajlar().gönderuserId='ben', gövde={'çiğ'}: ham} ).yürüt()
Unipile'ın E-posta API'si, tek bir birleşik uç nokta ile Gmail, Outlook ve IMAP hesaplarından e-posta göndermenizi sağlar; sağlayıcıya özel OAuth kurulumu gerekmez. Hesapları günler yerine dakikalar içinde bağlayın.
Gmail, Outlook, IMAP
Gmail API mi SMTP mi, Hangisini Kullanmalısınız?
Gmail API ve Gmail SMTP, e-postaları programlı olarak göndermenizi sağlar, ancak çok farklı kullanım durumlarına hizmet ederler. İşte seçiminize yardımcı olacak doğrudan bir karşılaştırma.
| Özellik | Gmail API | Gmail SMTP |
|---|---|---|
| Kimlik Doğrulama | OAuth 2.0 | Uygulama Şifresi veya OAuth |
| Günlük gönderme sınırı | 2,000 Çalışma alanı, 500 ücretsiz | 500/gün ücretsiz Gmail |
| Ekler | 25 MB'a kadar | 25 MB'a kadar |
| HTML e-postalar | Evet | Evet |
| İzleyici takibi | Etiketler ve başlıklar | Hayır |
| Makbuzları okuyun | Evet | Hayır |
| Programatik erişim | Tam, arama, etiketler, taslaklar, webhook'lar | Yalnızca gönder |
| Kurulum karmaşıklığı | Yüksek OAuth + Bulut Konsolu | Düşük Uygulama Parolası yalnızca |
| En iyisi | SaaS uygulamaları, CRM, ATS entegrasyonu | Basit betikler, kişisel kullanım |
Gmail API Hız Sınırları ve Kotalar
Gmail API hız sınırlarını anlamak üretime geçmeden önce önemlidir. Bu kotaları aşmak bir 429 hızSınırıAşıldı hata - her zaman üstel geri çekilme uygulayın.
Üstel Geri Çekilme ile Hız Sınırı Hatalarını Yönetme
Gmail API döndürdüğünde 429 Durum, yeniden denemeden önce bekleyin. API'ye aşırı yüklenmekten ve daha uzun engellemeleri tetiklemekten kaçınmak için üssel geri çekilme kullanın.
İthalat zaman itibaren googleapiclient.hataları İthalat HttpHatası fonksiyon yeniden_dene_ile_gönder(hizmet, kullanıcı_id, mesaj, yeniden_deneme_maks=3): için deneme içinde menzil(maksimum_denemeler): denemek: return hizmet.kullanıcılar().mesajlar().gönder( userId=user_id, body=message ).yürüt() hariç HttpHatası olarak hata: eğer hata.resp.durum == 429: # Hız sınırlandı# bekleme_süresi = (2 deneme) 1 # Exponential backoff: 1s, 2s, 4s print(f"Sınırlı istek. Yeniden denemek için {wait_time}s bekleniyor {attempt + 1}/{max_retries}..."zamanı.uyku(bekleme_süresi) aksi takdirde: yükseltmek # Oran sınırlaması hatalarını hemen yeniden yükselt yükseltmek İstisna(f"Gmail API, {max_retries} denemeden sonra e-posta gönderme başarısız oldu")
Yaygın Gmail API Hataları ve Bunları Düzeltme Yolları
Çoğu Gmail API e-posta gönderme hatası üç kategoriye ayrılır: kimlik doğrulama hataları (401), izin sorunları (403) ve hatalı biçimlendirilmiş istek hataları (400). İşte nedenleri ve düzeltmeleri içeren bir başvuru tablosu.
| HTTP Kodu | Hata Mesajı | Sebep | Çözüm |
|---|---|---|---|
| 401 | Yetkisiz | Erişim belirteci süresi doldu |
Kullanın
yenileme_belirteci yeni bir erişim belirteci almak için oauth2.googleapis.com/token
|
| 403 | Yasak | Yetersiz OAuth kapsamları |
Ekle
https://www.googleapis.com/auth/gmail.send kapsamı ve kullanıcıyı yeniden yetkilendir
|
| 403 | rateLimitAşıldı | Günlük kota aşıldı |
Üstel geri çekilme uygula - denemeler arasında 1s, 2s, 4s bekle. Yukarıdaki hız sınırları bölümüne bak.
|
| 400 | geçersiz_hibe | Yenileme belirteci iptal edildi veya süresi doldu |
Kullanıcının uygulamalarınız için yeniden kimlik doğrulaması yapması ve yeniden yetkilendirmesi gerekiyor. Yeni bir OAuth onay akışı isteyin.
|
| 400 | Kötü İstek | Bozuk biçimlendirilmiş MIME iletisi |
Mesajın şu şekilde kodlandığını doğrula
base64.urlsafe_b64encode() - standart base64 değil
|
| 403 | Yetersizİzinler | Yetkilendirme hatası eksik hizmet hesabı |
Google Workspace Yönetici'de alan çapında yetkilendirmeyi etkinleştirin ve hizmet hesabına Gmail API kapsamlarını verin
|
Birleşik bir çözüm mü arıyorsunuz? Unipile E-posta API Kılavuzu Gmail, Outlook, IMAP ve daha fazlasını tek bir entegrasyonla kapsar - tek uç nokta, tek kimlik doğrulama akışı, üç sağlayıcı.
E-posta API Kılavuzu'nu OkuOutlook ve IMAP'ı aynı API ile bağlayın
Unipile, Gmail'in ötesine geçer. Microsoft 365, Outlook.com ve herhangi bir IMAP posta kutusunu, Microsoft'ta sizin için halledilen OAuth ve IMAP için esnek kimlik bilgisi tabanlı kimlik doğrulama ile tek bir birleşik API üzerinden bağlayın.
Microsoft Graph API
Mail.Read
Mail.Gönder
çevrimdışı_erişim
Microsoft hesaplarını Unipile ile OAuth kullanarak bağlayın. Uygulamanızı şurada kaydedin Azure Aktif Dizin, AAD uygulama kimliğinizle Unipile'ı yapılandırın ve Outlook.com, Microsoft 365 ve Exchange Online üzerinden e-posta göndermeye başlayın.
IMAP API
Herhangi bir IMAP uyumlu posta kutusu için sunucu ayarlarını yapılandırın ve Unipile içinde uygun kimlik doğrulama yöntemini seçin. Güvenli bir bağlantı kurmak için ana bilgisayar, bağlantı noktası ve kimlik bilgilerini girin., OAuth akışı gerekmez.
Gmail API E-posta Gönder, Sıkça Sorulan Sorular
Gmail API ile programlı olarak e-posta göndermeyle ilgili en sık sorulan soruların yanıtları.
gmail.gönder kapsam, bir MIME mesajı oluştur, base64url formatında kodla, sonra POST at kullanıcıların.mesajları.gönder uç nokta. Bakınız Python örneği ve yukarıdaki Node.js kod örnekleri, eksiksiz, kopyala-yapıştır'a hazır bir uygulama için.
MIMEMultipart, dosyaları kullanın MIMEBase, tam mesajı base64url ile kodlayın ve Gmail API gönderi e-posta uç noktasından gönderin. Maksimum ek boyutu ileti başına 25 MB'tır. Yukarıdaki bölümdeki ekler kod örneğine bakın.
userId='target@domain.com' için kullanicilar().mesajlar().gonder(). Bireysel kullanıcı yetkilendirmesi için, lütfen tam Kullanıcı rehberi adına e-posta gönder.
429 hızSınırıAşıldı hataları zarifçe, eksiksiz bir kod örneği için yukarıdaki oran sınırlamaları bölümüne bakın.
MIMEMultipart('alternatif') her ikisiyle de metin/düz yedekleme ve bir text/html part. E-postayı göndermeden önce eksiksiz MIME iletisini base64url biçiminde kodlayın. Gmail API send email uç noktası aracılığıyla gönderin. Gmail istemcileri HTML sürümünü işler; diğer istemciler otomatik olarak düz metne geri döner.
401 Yetkisiz, erişim belirteciniz süresi doldu: kullanın yenileme_belirteci yenisini almak için oauth2.googleapis.com/token. 403 Yasak, kayıp gmail.gönder kapsam: doğru kapsamlarla yeniden yetkilendirin. 400 geçersiz_yetki, Yenileme jetonu iptal edildi: kullanıcının uygulamanızı baştan kimlik doğrulaması yapması gerekiyor.
Siz de beğenebilirsiniz
SaaS için Takvim Senkronizasyon API'si: Gerçek Zamanlı Google ve Outlook Entegrasyonu
CRM, ATS, sosyal yardım platformları ve yapay zeka odaklı yazılımlar için güvenilir bir Takvim API'si artık sahip olunması gereken bir şey değil. Artık üretkenliği, rezervasyon iş akışlarını, takipleri, otomatik dizileri ve ekip koordinasyonunu yönlendiren temel bir yapı taşıdır. Yine de takvim senkronizasyonunu uygulamak...
Takvim API Entegrasyonu için Eksiksiz Geliştirici Kılavuzu
Modern yazılımlar insanlar, sistemler ve zamanın kendisi arasındaki bağlantılarla çalışır. Bu bağlantının merkezinde, uygulamaların takvim etkinliklerini sorunsuz bir şekilde okumasını, oluşturmasını ve senkronize etmesini sağlayan hayati bir bileşen olan Calendar API yer alır. İster bir CRM, ister işe alım platformu ya da üretkenlik...
E-posta API'si: Geliştiriciler İçin Kapsamlı Rehber (2026)
E-posta API Sağlayıcı Ortamı Üç sağlayıcı, dünya genelindeki profesyonel e-postaların yaklaşık 'ini% kaplamaktadır: Gmail (ve Google Workspace), Microsoft Outlook / Microsoft 365 ve diğer her şey için evrensel IMAP / SMTP protokolleri. Her birinin neler sunduğunu ve aralarındaki farkları anlamak, ilk...
TR 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
PL