Google Dokümanlar API kapsamlarını seçme (original) (raw)
Bu belgede, Google Dokümanlar API'sine ö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.
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, dosya başına erişim kapsamı sağladığı ve erişimi bir uygulamanın ihtiyaç duyduğu belirli özelliklerle sınırladığı için hassas olmayan kapsamları kullanmanızı öneririz.
Docs API aşağıdaki kapsamları destekler:
| Kapsam kodu | Açıklama | Kullanım |
|---|---|---|
| https://www.googleapis.com/auth/documents | Google Dokümanlar'daki tüm dokümanlarınızı görme, düzenleme, oluşturma ve silme | Hassas |
| https://www.googleapis.com/auth/documents.readonly | Google Dokümanlar'daki tüm dokümanlarınızı görme | Hassas |
| https://www.googleapis.com/auth/drive.file | Bu uygulamayla kullandığınız belirli Google Drive dosyalarını görme, düzenleme, oluşturma ve silme | ÖnerilenHassas olmayan |
| https://www.googleapis.com/auth/drive | Tüm Google Drive dosyalarınızı görme, düzenleme, oluşturma ve silme | Kısıtlanmış |
| https://www.googleapis.com/auth/drive.readonly | Tüm Google Drive dosyalarınızı görün ve indirin. | Kısıtlanmış |
Tablodaki Kullanım sütunu, aşağıdaki tanımlara göre her kapsamın hassasiyetini gösterir:
- Hassas olmayan: Bu kapsamlar, en küçük yetkilendirme kapsamı erişimini sağlar ve yalnızca temel uygulama doğrulaması gerektirir. Bu şart hakkında bilgi için Uygulamanızı doğrulamaya gönderme başlıklı makaleyi inceleyin.
- Hassas: Bu kapsamlar, kullanıcının uygulamanız için yetkilendirdiği belirli Google Kullanıcı Verilerine erişim sağlar. Ek uygulama doğrulamasından geçmeniz gerekir. Bu şart hakkında bilgi edinmek için Hassas ve Kısıtlanmış Kapsam Şartları başlıklı makaleyi inceleyin.
- Kısıtlanmış: Bu kapsamlar, Google Kullanıcı Verilerine geniş erişim sağlar ve kısıtlanmış kapsam doğrulama sürecinden geçmenizi gerektirir. Bu şartla ilgili bilgi için Google API Hizmetleri Kullanıcı Verileri Politikası ve Belirli API Kapsamları İçin Ek Gereksinimler'i inceleyin. Kısıtlanmış kapsam verilerini sunucularda saklıyorsanız (veya iletiyorsanız) güvenlik değerlendirmesinden geçmeniz gerekir.
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.