LinkedIn
Instagram
WhatsApp
Telgraf
Google Takvim
Slack Topluluğuna KatılınGmail API Kapsamları Açıklandı: Seçimi Yaparken Sağ İzinler Uygulamanız İçin
Her Gmail API kapsamı belgelendi: from gmail.yalnızcaoku için mail.google.com. 3 hassasiyet seviyesini anlayın, uygulamanızın gerçekten ihtiyaç duyduğu minimum kapsamı seçin ve OAuth akışınızı daha hızlı yayınlayın.
// OAuth akışında Gmail API kapsamlarını isteyin
const KOŞULLAR = [
'https://www.googleapis.com/auth/gmail.readonly',
'https://www.googleapis.com/auth/gmail.send',
'https://www.googleapis.com/auth/gmail.labels',
];
const authUrl = oauth2Müvekkil.generateAuthUrl({
erişim_türü: 'çevrimdışı',
kapsam KAPSAMLAR,
Prompt: 'rıza',
});Gmail API Kapsamları Nelerdir?
Tek bir satır OAuth kodu yazmadan önce, Gmail API kapsamlarının ne olduğunu ve yanlış olanı seçmenin uygulamanızın üretime geçmesini neden engelleyebileceğini anlamanız gerekir. Bu bölüm size iki dakikanın altında temel bilgileri sunar.
Gmail API kapsamları Gmail API kapsamları, uygulamanızın bir kullanıcı adına hangi Gmail kaynaklarına tam olarak erişebileceğini tanımlayan OAuth 2.0 izin dizeleridir. Bir kullanıcı uygulamanızı yetkilendirdiğinde, Google uygulamanızın istediği Gmail API kapsamlarının listelendiği bir onay ekranı sunar. Kullanıcı bu kapsamlara göre erişimi onaylar veya reddeder. Onaylandıktan sonra, erişim jetonunuz o kapsamların izin verdiği eylemlerle tam olarak sınırlıdır; daha fazlası değil.
Gmail API kapsamları, jetonunuzun yapabileceği şeyler etrafında sert bir sınır oluşturur. Sunucunuz ele geçirilse bile, ele geçiren bir saldırgan gmail.yalnızcaoku Token e-posta gönderemez veya silemez. Kapsamlar Google tarafından sunucu tarafında zorunlu tutulur.
Kısıtlı Gmail API kapsamları, uygulamanızın 100'den fazla test kullanıcısıyla üretimde kullanılabilmesi için Google'ın güvenlik değerlendirmesinden geçmesini gerektirir. Yanlış kapsam seçimi, lansman zaman çizelgenize haftalar veya aylar ekleyebilir.
Uygulamanızın ihtiyaç duyduğundan daha fazla Gmail API izni istemek, "Bu uygulama Google Hesabınıza geniş erişim istiyor" uyarısını tetikler. Minimum Gmail API kapsamları, daha basit bir izin ekranı üreterek dönüşüm ve kullanıcı güvenini artırır.
Kapsam yönetimini tamamen atlayın. Unipile, Gmail OAuth ve kapsamlarını dahili olarak yönetir - ekibiniz izin dizgileriyle değil, ürün mantığına odaklanır.
Unipile ile oluşturun3 Hassasiyet Seviyesi Açıklaması
Google, tüm Gmail API kapsamlarını 3 hassasiyet düzeyine ayırır. Her düzey, uygulamanızın yayına çıkmadan önce karşılaşması gereken doğrulama gereksinimlerini belirler. Bu sınıflandırmayı anlamak, Gmail entegrasyonunuzu planlarken yapacağınız en önemli karardır.
En düşük risk seviyesi. Bu kapsamlar sınırlı, kişisel olmayan Gmail verilerine erişir. Google, bunları üretimde kullanmak için resmi bir güvenlik değerlendirmesi gerektirmez.
Orta risk katmanı. Bu kapsamlar, kişisel bilgileri açığa çıkarabilecek Gmail mesaj verilerine erişir. Üretim kullanımı öncesinde ek doğrulama gereklidir.
En yüksek risk seviyesi. Bu kapsamlar, Gmail verilerine geniş veya hassas erişim sağlar. Google, onaylı üçüncü taraf bir denetçi tarafından resmi bir güvenlik değerlendirmesi talep eder.
| Kriterler | Hassas değil | Hassas | Kısıtlı |
|---|---|---|---|
| Mesaj gövdesine erişir | Hayır | Bazen | Evet |
| Güvenlik değerlendirmesi gerekli | Hayır | Hayır | Evet |
| Uygulama incelemesi gerekli | Evet | Evet | Evet |
| Yıllık yeniden sertifikasyon | Hayır | Hayır | Evet |
| Onam ekranı uyarı seviyesi | Standart | Standart + açıklama | Geniş erişim uyarısı |
| Tipik doğrulama maliyeti | Ücretsiz | Ücretsiz | ~$500/yıl (değerlendirici) |
Tam Gmail API Kapsam Başvurusu
Gmail API kapsamlarının hassasiyet düzeylerine göre gruplandırılmış tam listesi. Uygulamanız için Gmail API izinlerini seçerken bu tabloyu tek referansınız olarak kullanın. "2026" olarak işaretlenen kapsamlar, Google'ın kapsam listesindeki en son eklemeleri yansıtmaktadır.
| Kapsam URI'si | Erişim Seviyesi | Ne Erişir | Ne Zaman Kullanılır |
|---|---|---|---|
| gmail.addon.mevcut.eylem.oluştur | Hassas değil | E-posta oluşturma işlemi sırasında eklentilerin e-posta oluşturmasına ve göndermesine izin verir | Kullanıcı adına e-posta taslaklayan veya gönderen Gmail eklentileri |
| gmail.addons.current.message.action | Hassas değil | Eklentilerin, bir ileti eylemi sırasında geçerli e-postayı görüntülemesine izin verir | Bir e-posta işlemine (arşivleme, etiketleme) e-posta bağlamında yanıt veren Gmail eklentileri |
| gmail etiketleri 2026 | Hassas değil | Etiketleri görüntüleyin ve düzenleyin (oluşturma, yeniden adlandırma, silme), ancak ileti içeriğini düzenlemeyin | Etiketlerle e-postaları mesaj gövdelerini okumaya gerek kalmadan düzenleyen uygulamalar |
| Kapsam URI'si | Erişim Seviyesi | Ne Erişir | Ne Zaman Kullanılır |
|---|---|---|---|
| gmail.eklentiler.mevcut.mesaj.metaveri | Hassas | E-posta üstbilgileri ve meta veriler (Kimden, Kime, Konu, Tarih) eklenti bağlamında - ileti gövdesi değil | Gövdeyi okumadan gönderene veya konuya göre bağlamsal bilgileri görüntüleyen eklentiler |
| gmail.eklentileri.mevcut.mesaj.saltokunur | Hassas | E-postanın tamamına, gövdesine ve eklerine eklenti bağlamında tam okuma erişimi | Açık iletiyi analiz eden veya verilerini çıkaran eklentiler |
| gmail.gönder | Hassas | Kimliği doğrulanmış kullanıcı adına e-posta gönder - okuma veya değiştirme izni yok | Yalnızca işlem veya tanıtım e-postaları gönderen ve gelen kutusunu okumaya gerek duymayan uygulamalar |
| Kapsam URI'si | Erişim Seviyesi | Ne Erişir | Ne Zaman Kullanılır |
|---|---|---|---|
| mail.google.com/ | Kısıtlı | Gelen kutusuna tam erişim: e-postaları ve ayarları oku, yaz, gönder ve kalıcı olarak sil | Yalnızca her Gmail yeteneğine tek bir kapsamda ihtiyaç duyduğunuzda - tipik olarak eski entegrasyonlar |
| gmail.yalnızcaoku | Kısıtlı | Tüm mesajlara, konulara, etiketlere ve ayarlara salt okunur erişim - gönderemez veya değiştiremez | Yalnızca gelen kutusu verilerini okuyan analiz, arşivleme, arama veya e-posta zekası araçları |
| gmail.olustur | Kısıtlı | Taslakları oluşturun ve yönetin, taslakları gönderin - mevcut e-postalara erişim yok | Taslak yönetim araçları, e-posta düzenleyiciler veya göndermeden önce e-postaları sıraya sokan uygulamalar |
| gmail.ekle 2026 | Kısıtlı | Yalnızca Gmail gelen kutusuna mesaj ekleyin - mevcut e-postaları okuyamaz veya gönderemezsiniz | Gmail'e harici kaynaklardan e-posta aktarma araçları veya sistemleri |
| gmail.değiştir | Kısıtlı | E-postaları ve etiketleri okuyun, oluşturun, gönderin ve yönetin - kalıcı olarak silemezsiniz | Tam özellikli e-posta istemcileri, CRM senkronizasyon araçları, okuma+gönderme+etiketleme gerektiren yardım masası entegrasyonları |
| gmail.metaveri | Kısıtlı | Yalnızca başlıklar ve etiketler - e-posta gövdesine veya eklerine erişim yok | Özel içeriği okumadan, meta verilere göre e-postaları kategorize eden veya yönlendiren uygulamalar |
| gmail.ayarlar.temel | Kısıtlı | Temel Gmail ayarlarını yönetin: filtreler, yönlendirme kuralları, POP/IMAP ayarları | Kullanıcılar adına Gmail yönlendirme veya filtreleme yapılandıran e-posta verimliliği araçları |
| gmail.ayarlar.paylaşım | Kısıtlı | Hassas ayarlar yönetimi: gönderme takma adları, vekiller, tatil yanıtlayıcıları (yalnızca alan yöneticisi) | Yalnızca Çalışma Alanı yönetici araçları - etkinleştirmek için alan yöneticisi ayrıcalıkları gerektirir |
Bu gmail api kapsamlarını manuel olarak yönetmeyin. Unipile'ın Gmail entegrasyonu, kullanıcılarınızın bağlı hesaplarında OAuth kapsam isteklerini, belirteç yenilemeyi ve yeniden yetkilendirme akışlarını otomatik olarak yönetir.
Gmail uygulamanızı oluşturunHangi Gmail API kapsamına ihtiyacınız var?
Gmail API kapsam seçimi için en önemli prensip minimum erişim prensibidir: uygulamanızın gerçekten ihtiyaç duyduğu Gmail API izinlerini isteyin. Bu tablo, yaygın kullanım senaryolarını minimum önerilen kapsama eşler, gereksiz doğrulama yükünden kaçınmanıza ve kullanıcı güvenini korumanıza yardımcı olur.
| Kullanım Örneği | Minimum Kapsam | Doğrulama Seviyesi | Notlar |
|---|---|---|---|
| Yalnızca e-posta gönder (gelen kutusunu okuma) | gmail.gönder | Hassas | İşlemsel veya dışa dönük araçlar için idealdir. Mevcut mesajlara erişim yoktur. |
| Analitikler veya arama için gelen kutusunu oku | gmail.yalnızcaoku | Kısıtlı | Tüm mesaj ve ayarlara tam okuma erişimi. Yıllık güvenlik değerlendirmesi gerektirir. |
| Tam e-posta istemcisi (oku + gönder + etiketle) | gmail.değiştir | Kısıtlı | Tercih edilen mail.google.com/ kalıcı silmeyi hariç tutuyor. CRM ve yardım masası kullanım durumlarının çoğunu kapsar. |
| E-postaları kalıcı olarak arşivle veya yedekle | mail.google.com/ | Kısıtlı | Yalnızca gerçekten silme erişimine ihtiyaç duyduğunuzda kullanın. En geniş Google onay uyarısını tetikler. |
| Etiketleri düzenle | gmail etiketleri | Hassas değil | 2026'da yenilik. Mesajları okumadan etiket yönetimi için minimum izinler. |
| Taslak yönetimi (göndermeden önce kuyruk) | gmail.olustur | Kısıtlı | Taslaklara erişim ve gönderme, ancak mevcut mesajları okuma erişimi yok. |
| Metaveri yönlendirme veya kategorizasyon | gmail.metaveri | Kısıtlı | Yalnızca başlıklar ve etiketler - gövde erişimi yok. Mesaj gizliliğine saygı duyan yönlendirme motorları için iyidir. |
| Gmail'e E-posta Taşıma / İçe Aktarma | gmail.ekle | Kısıtlı | 2026'da yenilik. Yalnızca ekleme erişimi - daha iyi kapsama alanına sahip alternatif mail.google.com/ içe aktarma araçları için. |
| Gmail filtrelerini ve yönlendirmesini yapılandırın | gmail.ayarlar.temel | Kısıtlı | Filtreleri, etiketleri, yönlendirme kurallarını yönetin. Mesaj gövdesine erişim yok. |
| Gmail eklentisi: gönderici bağlamını göster | gmail.eklentiler.mevcut.mesaj.metaveri | Hassas | Yalnızca eklenti bağlamında başlıklar. Tam mesajı okuma erişiminden kaçınır. |
Tek bir OAuth isteğinde birden fazla Gmail API kapsamını birleştirebilirsiniz (örneğin, gmail.gönder + gmail etiketleri), ancak her kapsam, onay ekranı bildirimine eklenir. Her zaman üretime geçmeden önce kapsam listenizi denetleyin. Tam bir Gmail senkronizasyon ürünü oluşturuyorsanız, OAuth E-posta API kılavuzu token yönetimi ve kapsam yeniden yetkilendirmeyi içeren tam akışı kapsar.
Kısıtlı Kapsam Doğrulaması: Uygulamanız İçin Ne Anlama Geliyor
Uygulamanız, kısıtlı Gmail API kapsamlarından herhangi birini gerektiriyorsa - buna gmail.yalnızcaoku, gmail.değiştirveya mail.google.com/ - Canlıya geçmeden ve 100'den fazla test kullanıcısına ulaşmadan önce Google'ın güvenlik değerlendirme sürecini tamamlamanız gerekir. Sürecin nasıl işlediği ve ek yükü nasıl azaltabileceğiniz aşağıda açıklanmıştır.
Bir proje oluşturun, Gmail API'sini etkinleştirin ve OAuth onay ekranını yapılandırın. Gerekli tüm alanları doldurun: uygulama adı, destek e-postası, yetkili alanlar ve gizlilik politikası URL'si. Bu adım, herhangi bir Gmail API kapsamı düzeyi için gereklidir.
Yetkilendirme ekranında "Doğrulama İçin Hazırlan" düğmesine tıklayın. Sınırlı her Gmail API kapsamını bildirin ve uygulamanızın neden buna ihtiyaç duyduğuna dair bir gerekçe sağlayın. Google ekibi, sizi bir güvenlik denetçisine yönlendirmeden önce bunu inceler.
Google, sınırlı kapsamlı uygulamaları onaylı bir denetçiye (Leviathan Security, Coalfire vb.) yönlendirir. Değerlendirme ücreti yıllık yaklaşık 1.450 $'dır. Bir demo sunmanız, veri işleme uygulamalarınızı açıklamanız ve OAuth uygulamanızın teknik incelemesinden geçmeniz gerekir.
Kısıtlanmış Gmail API kapsamları yıllık yeniden sertifikasyon gerektirir. Yenileme penceresini kaçırırsanız, Google uygulamanızın üretim erişimini kaldırabilir. Bu yinelenen maliyet ve uyumluluk döngüsünü, Gmail entegrasyon mimarinizin ilk gününden itibaren planlayın.
Seç gmail.gönder üstünde gmail.değiştir E-posta göndermeniz gereken ancak gelen kutusunu okumanıza gerek duymayan uygulamanız için. gmail.gönder hassas (kısıtlı olmayan) bir kapsamdır ve güvenlik değerlendirmesini tamamen atlar.
Kullanım gmail.metaveri yerine gmail.yalnızcaoku Uygulamanız e-postaların gövde içeriğini okumadan yönlendirme veya kategorize etme yapıyorsa, yine de doğrulama gereklidir. Ancak bu doğrulama daha dar kapsamlı ve Google'a gerekçelendirmesi daha kolaydır.
Google doğrulamasına sahip bir platform kullanın. Üzerine inşa ettiğinizde Unipile'ın Gmail entegrasyonu, uygulamanız, Unipile'ın önceden doğrulanmış OAuth kimlik bilgilerinden yararlanır, bu nedenle kısıtlı kapsam değerlendirmesinden kendiniz geçmeniz gerekmez. Bu, çoğu SaaS ürünü için üretime geçişin en hızlı yoludur.
100 kullanıcı test penceresinde kalın Erken geliştirme sırasında. Tam doğrulamayı tamamlamadan 100 adede kadar Google hesabıyla kısıtlı Gmail API kapsamlarını test edebilirsiniz. Test hesaplarını Google Cloud Console OAuth izin ekranı ayarlarına ekleyin.
Google doğrulama sürecini tamamen atlayın. Unipile'ın barındırılan Gmail OAuth'u, kısıtlı Gmail API kapsamları için zaten doğrulanmıştır - bağlı hesaplarınız ek bir değerlendirme gerekmeden anında bağlanır.
Bugün inşa etmeye başlaOAuth Akışınızda Gmail API Kapsamlarını İsteme Yöntemleri
Uygulamanızın hangi Gmail OAuth kapsamlarına ihtiyaç duyduğunu öğrendikten sonra, bunları yetkilendirme URL'sini oluştururken beyan edersiniz. İşte Gmail API izinlerini OAuth onay ekranına tam olarak nasıl geçireceğinizi gösteren hem Node.js hem de Python'da çalışan kod örnekleri.
// Node.js — OAuth akışında Gmail API kapsamları
// google-auth-library'yi kullanır (resmi Google istemcisi)
const { OAuth2Client } = require('google-kimlikDoğrulama-kütüphanesi');
const oauth2Client = yeni OAuth2İstemci(
process.env.GOOGLE_CLIENT_ID,
process.env.GOOGLE_CLIENT_SECRET,
process.env.YENIDEN_YONLENDIRME_URI
);
// Uygulamanızın ihtiyaç duyduğu gmail api kapsamlarını tanımlayın
Prensip: Gerekli minimum kapsamı isteyin
const KAPSAMLAR = [
'https://www.googleapis.com/auth/gmail.readonly', // kısıtlı
'https://www.googleapis.com/auth/gmail.send', // hassas
'https://www.googleapis.com/auth/gmail.labels', // hassas olmayan
];
// OAuth yetkilendirme URL'sini oluştur
const authUrl = oauth2Müvekkil.generateAuthUrl({
erişim_türü: 'çevrimdışı', // yenileme belirtecini iste
kapsam: KAPSAMLAR,
Prompt: 'rıza', // yenileme belirtecini almak için izni zorla
});
konsol.log('Kullanıcıyı şuraya yönlendir:', authUrl);
// Kullanıcı yetkilendirmesinden sonra, kod karşılığında jetonları değiştirin
async function Tokenleri al(kod) {
const { belirteçler } = bekliyor oauth2Müvekkil.token al(kod);
oauth2Müvekkil.kimlik bilgilerini ayarla(belirteçler);
return jetonlar;
}# Python — OAuth akışında Gmail API kapsamları
#, google-auth-oauthlib’i (resmi Google kütüphanesi) kullanır
itibaren google_auth_oauthlib.flow İthalat YüklüUygulamaAkışı
itibaren google.oauth2.kimlik bilgileri İthalat Kimlik Bilgileri
itibaren google.auth.transport.requests İthalat Talep
İthalat işletim sistemi
# Gmail API kapsamlarını tanımlayın - sadece ihtiyacınız olanları isteyin
KAPSAMLAR = [
'https://www.googleapis.com/auth/gmail.readonly', # kısıtlı
'https://www.googleapis.com/auth/gmail.send', # duyarlı
'https://www.googleapis.com/auth/gmail.labels', # hassas olmayan
]
fonksiyon gmail_kimlik_bilgilerini_al():
kimlik bilgileri = Hiçbiri
# Mevcut jeton varsa yükle
eğer os.path.var('token.json'):
creds = Kimlik Bilgileri.yetkili_kullanıcı_dosyası(
'token.json', KAPSAMLAR
)
# Kimlik bilgilerini yenile veya yeni kimlik bilgileri iste
eğer değilse kimlik bilgileri ya da değil cred.geçerli:
eğer kimlik bilgileri ve kimlik bilgileri.süresi_doldu ve creds.yenileme_belirteci:
kimlik bilgileri.yenile(Talep())
aksi takdirde:
# Belirtilen kapsamlarla OAuth onay ekranını tetikle
akış = InstalledAppFlow.dosyadan_istemci_gizli_anahtarları(
'kimlikbilgileri.json', KAPSAMLAR
)
creds = akış.yerel_sunucuyu_çalıştır(port=0)
# Gelecekteki çalıştırmalar için kalıcı belirteç
ile aç('token.json', 'w') simgesi olarak:
jeton.Yaz( krediler.to_json())
return kimlik bilgileriÖnemli: Bu rıza' (Node.js) veya yerel_sunucuyu_çalıştır call (Python) kullanıcı daha önce yetkilendirmiş olsa bile Google onay ekranının görünmesini sağlar. Bu, güvenilir bir şekilde elde etmek için gereklidir yenileme_belirteci. Yenileme jetonu olmadan, erişim jetonunuz 1 saat sonra geçerliliğini yitirir ve kullanıcıların yeniden yetkilendirme yapması gerekir. Jeton yenileme ve kapsam yeniden yetkilendirmeyi işleme hakkında eksiksiz bir kılavuz için bkz. OAuth E-posta API kılavuzu ve Unipile Google OAuth belgeleri.
Minimum Kapsam İlkesi ve Uyumluluk
Asgari kapsam ilkesi sadece bir Google tavsiyesi değildir; GDPR ve SOC 2 uyumluluk durumunuzu doğrudan etkiler. Aşırı gmail api izni istemek gereksiz veri maruz kalma riskleri oluşturur ve son kullanıcılarla olan veri işleme anlaşmalarınızı karmaşıklaştırır.
Asgari kapsam ilkesi, en az ayrıcalık güvenlik konseptini yansıtır. Gmail API entegrasyonunuzun istemesi gereken En düşük izinli Gmail API kapsamı özelliği etkinleştiren. CRM'iniz yalnızca takip e-postaları gönderiyorsa, gmail.gönder yeter gmail.değiştir aşırı ve gereksiz risk oluşturuyor.
Google, beyan ettiğiniz Gmail API kapsamlarını doğrudan izin ekranında gösterir. Daha geniş kapsamlar daha rahatsız edici bir dil tetikler ("Bu uygulama, tüm Gmail gelen kutunuza erişmek istiyor"). Minimal Gmail OAuth kapsamları daha basit ve kullanıcıları ürkütmeyen onay ekranları oluşturur; bu sayede, kullanıcıya yönelik OAuth akışlarında yetkilendirme dönüşüm oranlarını genellikle -30 oranında artırır.
Gizlilik politikanız ve DPA (Veri İşleme Sözleşmeniz), uygulamanızın hangi Gmail verilerine eriştiğini doğru bir şekilde yansıtmalıdır. Uygulamanız talep ederse gmail.yalnızcaoku ancak gizlilik politikanızda yalnızca "e-posta gönderme"den bahsediliyor, GDPR dokümantasyonunuzda bir eksiklik var. Beyan ettiğiniz gmail api kapsamlarını yayınladığınız veri uygulamalarınızla eşleştirin.
Gmail API kapsam gereksinimleri, özellikler eklendikçe veya kaldırıldıkça evrimleşir. Her büyük sürümde bir kapsam denetimi yapın: mevcut özellik kümenizin artık gerektirmediği gmail api izinlerini kaldırın. OAuth beyanınızdaki kullanılmayan kapsamlar uyumluluk açısından bir risk oluşturur - bunlar kullandığınızı iddia ettiğiniz ancak kullanmadığınız veri erişimini temsil eder.
gmail.metaveri yerine gmail.yalnızcaoku gövde erişiminin gerekmediği zaman
Uyumlu Gmail entegrasyonu. Unipile'ın Gmail API uygulaması varsayılan olarak asgari kapsam ilkesini izler; uygulamanız yalnızca etkinleştirdiğiniz özellikler için gereken Gmail OAuth kapsamlarını ister.
Uygun Gmail uygulamaları oluşturunUnipile ile Gmail API Kapsamları: Kapsam Karmaşasını Atlayın
Gmail API kapsamlarını manuel olarak yönetmek, Google'ın doğrulama sürecini yönetmek, kapsam değişikliklerinde jeton yenileme işlemini halletmek ve özellik eklediğinizde veri işleme belgelerinizi her seferinde güncellemek anlamına gelir. Unipile bunu tamamen soyutlar, ekibiniz izin dizgileriyle değil, ürünle ilgilenir.
Gmail
Görünüm
IMAP
Unipile, kısıtlı Gmail API kapsamları için Google'ın OAuth doğrulamasını barındırır. Uygulamanız ayrı bir güvenlik değerlendirmesini tamamlamadan hemen fayda sağlar. Yıllık yeniden sertifikasyon, Unipile'ın uyumluluk ekibi tarafından yürütülür.
Unipile, kullanıcılarınızın bağlı hesaplarının her biri için OAuth belirteci yenileme, kapsam doğrulama ve yeniden yetkilendirme akışlarını yönetir. Google kapsam gereksinimlerini güncellediğinde, Unipile entegrasyonunuzu bozmadan uyum sağlar.
Aynı Unipile API çağrıları Gmail, Outlook ve IMAP için çalışır. E-posta özelliğinizi bir kez yazarsınız ve tüm sağlayıcılarda çalışır, sağlayıcı başına ayrı Gmail API kapsam yönetimi yok, protokole özgü kod dallanması yok.
Kendi Google kimlik bilgilerini kullanması gereken ekipler için Unipile, özel markalı OAuth yapılandırmasını destekler. Kullanıcılarınız onay ekranında markanızı görürken Unipile arka planda kapsam bildirimini ve jeton yaşam döngüsünü yönetir.
Unipile'ın Gmail entegrasyonu yalnızca etkinleştirdiğiniz özellikler için gereken Gmail API izinlerini ister. Okuma, gönderme, senkronize etme gibi her yetenek mümkün olan en dar kapsamı eşler ve uyumluluk profilinizi temiz tutar.
Unipile webhook'ları aracılığıyla yeni Gmail mesajlarını geldiği anda alın. Sorgulama yok, Gmail Pub/Sub aboneliklerini manuel olarak yönetme yok. Uygulamanızın diğer Gmail API işlemleri için zaten kullandığı OAuth jetonuyla uyumludur.
Gmail API Kapsamları Hakkında Sıkça Sorulan Sorular
Gmail API kapsamları, Gmail OAuth kapsamları ve doğrulama süreci hakkında geliştiriciler için Gmail entegrasyonları oluştururken yanıtlanan yaygın sorular.
gmail.yalnızcaoku ve gmail.değiştir kısıtlanmış gmail api kapsamlarıdır. gmail.yalnızcaoku mesajların, konuşmaların, etiketlerin ve ayarların tümüne salt okunur erişim sağlar - uygulamanız hiçbir şeyi gönderemez veya değiştiremez. gmail.değiştir E-posta okuma, yazma, gönderme ve etiketleri yönetme yeteneği ekler, ancak kalıcı mesaj silme özelliğini dışlar. Uygulamanız okuma ve gönderme ancak silme işlemi yapmıyorsa, gmail.değiştir daha geniş olana tercih edilir mail.google.com/ kapsam. Bizim E-posta istemcisindeki kullanıcı e-postalarını birleştirilmiş bir API aracılığıyla okuma.gmail etiketleri yalnızca standart OAuth uygulama incelemesi gerektirir. Hassas kapsamlar gibi gmail.gönder Google'ın OAuth doğrulama sürecini gerektirir ancak güvenlik değerlendirmesi yok. Kısıtlı kapsamlar - dahil olmak üzere gmail.yalnızcaoku, gmail.değiştir, gmail.olustur, gmail.metaveri, gmail.ekleve mail.google.com/ - tam değerlendirme sürecini gerektirir. Bu konuda daha fazla bilgiyi şu adresimizde bulabilirsiniz Düzenlemeye tabi sektörler için güvenli e-posta API desenleri.gmail.değiştir kapsam, Gmail'e okuma, oluşturma, gönderme ve etiket yönetimi erişimi sağlar, ancak mesajları kalıcı olarak silme yeteneğini hariç tutar. Bu, aşağıdakiler gibi tam özellikli e-posta tümleştirmeleri için önerilen kısıtlı kapsamdır CRM e-posta senkronizasyonu, yardım masası araçları ve e-posta istemcileri hem mesaj okuyup hem de göndermesi gereken kişilerin tercih ettiği bir yöntemdir. mail.google.com/ çünkü kalıcı silme işlevini dışlayarak veri maruziyetini sınırlar. İlgili: Kullanıcılar adına e-posta gönderme.kapsam parametre. Örneğin, isteğinde bulunabilirsin gmail.gönder + gmail etiketleri birlikte. Ancak, kapsamları birleştirmek Google'ın onay ekranında gösterilen izinleri artırır ve birleştirilmiş herhangi bir kapsam kısıtlıysa ek doğrulama gereksinimlerini tetikleyebilir. Uygulamanızın gerçekten ihtiyaç duyduğu minimum birleşimi her zaman isteyin. Microsoft tarafı için, bkz. Microsoft Graph OAuth kapsamları karşılığı.gmail.metaveri scope, erişim sağlayan kısıtlı bir gmail api kapsamıdır e-posta üstbilgileri ve etiketleri, e-posta gövdesine veya eklerine erişim olmadan. Gönderen, alıcı, konu veya etiketlere göre, özel mesaj içeriğini okumadan e-postaları işleyen yönlendirme motorları, kategorizasyon sistemleri veya analiz araçları için kullanışlıdır. Kısıtlı olmasına rağmen, daha dar bir veri ayak izine sahiptir gmail.yalnızcaoku ve bir güvenlik değerlendirmesinde gerekçelendirmesi daha kolay olabilir. Daha derinlemesine inceliyoruz tam gelen kutusu senkronizasyonu için e-posta senkronizasyon API'si.gmail.gönder kapsam bir hassas gmail api kapsamı Uygulamanızın kimliği doğrulanmış bir kullanıcı adına, mevcut mesajlara okuma veya değiştirme erişimi vermeden e-posta göndermesine olanak tanır. Yalnızca e-posta gönderen uygulamalar için önerilen minimum kapsamdır - tanıtım araçları, bildirim sistemleri veya takip otomasyonu. Kullanarak gmail.gönder yerine gmail.değiştir kısıtlanmış kapsamlı güvenlik değerlendirmesinden tamamen kaçınarak, üretim yolunuzu önemli ölçüde hızlandırır. Bizimkini görün Özel E-posta Gönderme API kılavuzu.
TR 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
PL