Bu belgede, Gmail API'ye özel yetkilendirme ve kimlik doğrulama bilgileri yer almaktadır. Bu belgeyi okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuduğunuzdan emin olun.
Yetkilendirme için OAuth 2.0'ı yapılandırma
Kullanıcılara ve uygulama inceleyicilerine hangi bilgilerin gösterileceğini tanımlamak için OAuth kullanıcı rızası ekranını yapılandırın ve kapsamları seçin. Ayrıca, uygulamanızı daha sonra yayınlayabilmek için kaydedin.
Gmail API kapsamları
Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını belirleyip bildirmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulama adını, eriştiği veri türünü ve erişim düzeyini içeren bir OAuth 2.0 URI dizesidir. Kapsamlar, uygulamanızın kullanıcıların Google Hesabı verileri de dahil olmak üzere Google Workspace verileriyle çalışmak için yaptığı isteklerdir.
Uygulamanız yüklendiğinde, kullanıcıdan uygulama tarafından kullanılan kapsamları doğrulaması istenir. Genellikle, mümkün olan en dar kapsamı seçmeli ve uygulamanızın gerektirmediği kapsamları istemekten kaçınmalısınız. Kullanıcılar, sınırlı ve net bir şekilde açıklanmış kapsamlara daha kolay erişim izni verir.
Mümkün olduğunda, erişimi yalnızca bir uygulamanın ihtiyaç duyduğu belirli özelliklerle sınırlamak için hassas olmayan kapsamlar kullanın.
Hassas olmayan kapsamlar
Çoğu kullanım alanı için aşağıdaki Gmail API kapsamları önerilir:
| Kapsam kodu | Açıklama |
|---|---|
https://www.googleapis.com/auth/gmail.addons.current.action.compose |
Eklentiyle etkileşimde bulunduğunuzda taslakları yönetme ve e-posta gönderme |
https://www.googleapis.com/auth/gmail.addons.current.message.action |
Eklentiyle etkileşimde bulunduğunuzda e-posta iletilerinizi görüntüleme |
https://www.googleapis.com/auth/gmail.labels |
E-posta etiketlerinizi görüntüleme ve düzenleme |
Hassas kapsamlar
| Kapsam kodu | Açıklama |
|---|---|
https://www.googleapis.com/auth/gmail.addons.current.message.metadata |
Eklenti çalışırken e-posta iletisi meta verilerinizi görüntüleme |
https://www.googleapis.com/auth/gmail.addons.current.message.readonly |
Eklenti çalışırken e-posta iletilerinizi görüntüleme |
https://www.googleapis.com/auth/gmail.send |
Sizin adınıza e-posta gönderme |
Kısıtlanmış kapsamlar
| Kapsam kodu | Açıklama |
|---|---|
https://mail.google.com/ |
Gmail'deki tüm e-postalarınızı okuyun, oluşturun, gönderin ve kalıcı olarak silin.
Not: Bu kapsamı yalnızca uygulamanızın, çöp kutusunu atlayarak ileti dizilerini ve mesajları hemen ve kalıcı olarak silmesi gerekiyorsa isteyin. Diğer tüm işlemleri daha az izin veren kapsamlar kullanarak gerçekleştirebilirsiniz. |
https://www.googleapis.com/auth/gmail.readonly |
E-posta iletilerinizi ve ayarlarınızı görüntüleme |
https://www.googleapis.com/auth/gmail.compose |
Taslakları yönetme ve e-posta gönderme |
https://www.googleapis.com/auth/gmail.insert |
Gmail gelen kutunuza e-posta ekleme |
https://www.googleapis.com/auth/gmail.modify |
Gmail hesabınızdan e-postaları okuma, oluşturma ve gönderme Bu kapsam, ileti dizilerinin ve iletilerin çöp kutusuna gönderilmeden hemen kalıcı olarak silinmesine izin vermez. |
https://www.googleapis.com/auth/gmail.metadata |
E-posta mesajı hariç, etiketler ve üstbilgiler gibi e-posta iletisi meta verilerinizi görüntüleme |
https://www.googleapis.com/auth/gmail.settings.basic |
Gmail'de e-posta ayarlarınızı ve filtrelerinizi görüntüleme, düzenleme, oluşturma veya değiştirme |
https://www.googleapis.com/auth/gmail.settings.sharing |
Postalarınızı kimin yönetebileceği de dahil, hassas posta ayarlarınızı yönetme
Not: Bu kapsam tarafından korunan işlemler yalnızca yönetimsel kullanımla sınırlıdır. Bu özellikler yalnızca alan genelinde yetkiyle hizmet hesabı kullanan Google Workspace müşterileri tarafından kullanılabilir. |
Önceki tablolardaki kapsamlar, aşağıdaki tanımlara göre hassasiyetlerini gösterir:
Hassas olmayan: Bu kapsamlar, en küçük yetkilendirme kapsamını sağlar ve yalnızca temel OAuth uygulaması doğrulaması gerektirir. Daha fazla bilgi için Doğrulama koşulları başlıklı makaleyi inceleyin.
Hassas: Bu kapsamlar, kullanıcıların uygulamanız için yetkilendirdiği belirli Google kullanıcı verilerine erişim sağlar. Ek OAuth Uygulaması Doğrulaması gerektirirler. Daha fazla bilgi için Hassas ve Kısıtlanmış Kapsam Koşulları başlıklı makaleyi inceleyin.
Kısıtlı: Bu kapsamlar, Google kullanıcı verilerine geniş erişim sağlar ve kısıtlı kapsam OAuth Uygulaması Doğrulaması gerektirir. Daha fazla bilgi için Google API Hizmetleri Kullanıcı Verileri Politikası ve Belirli API Kapsamları İçin Ek Gereksinimler başlıklı makaleleri inceleyin.
Kısıtlanmış kapsam verilerini sunucularda saklıyorsanız (veya iletiyorsanız) güvenlik değerlendirmesinden geçmeniz gerekir.
Kullanıcı verilerine erişim isteğinde bulunduğunuzda Gmail API'lerini kullanımınızı ve bunlara erişiminizi düzenleyen ek bilgileri Google Workspace API kullanıcı verileri ve geliştirici politikası'nda bulabilirsiniz.
Uygulamanızın başka Google API'lerine erişmesi gerekiyorsa bu kapsamları da ekleyebilirsiniz. Google API kapsamları hakkında daha fazla bilgi için Google API'lerine Erişmek İçin OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.
Belirli OAuth 2.0 kapsamları hakkında daha fazla bilgi için Google API'leri için OAuth 2.0 Kapsamları başlıklı makaleyi inceleyin.
OAuth doğrulaması
Belirli hassas OAuth kapsamlarının kullanılması için uygulamanızın Google'ın OAuth doğrulama sürecini tamamlaması gerekebilir. OAuth Uygulaması Doğrulaması SSS, bunun gerekli olup olmadığını ve hangi tür doğrulamanın gerekli olduğunu belirlemenize yardımcı olabilir.