Google Sheets API kapsamlarını seçme

Bu belgede, Google E-Tablolar API'ye özel yetkilendirme ve kimlik doğrulama bilgileri yer almaktadır. Bu dokümanı okumadan önce, Kimlik doğrulama ve yetkilendirme hakkında bilgi edinin başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuyun.

Sheets API kapsamlarının bir e-tablo dosyasına uygulandığını ve belirli bir sayfa ile sınırlı olamayacağını unutmayın. Bir sayfanın değiştirilmesini önlemek için düzenlenemeyen bir hücre veya hücre aralığı tanımlamak üzere ProtectedRange kullanın. Örnek için Adlandırılmış ve korunan aralıklar bölümüne bakın.

Yetkilendirme için OAuth 2.0'ı yapılandırma

Kullanıcılara ve uygulama incelemecilerine hangi bilgilerin gösterileceğini tanımlamak için OAuth kullanıcı rızası ekranını yapılandırın ve kapsamları seçin. Ardından, uygulamanızı daha sonra yayınlayabilmek için kaydedin.

Sheets API kapsamları

Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını tanımlamanız ve belirtmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulamasının 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ışma istekleridir.

Uygulamanız yüklendiğinde kullanıcıdan uygulamanın kullandığı kapsamları doğrulaması istenir. Genel olarak, 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 açıkça açıklanan kapsamlara daha kolay erişim izni verir.

Mümkün olduğunda, dosya başına erişim kapsamı sağladığı ve bir uygulamanın ihtiyaç duyduğu belirli özelliklere erişimi daralttığı için hassas olmayan kapsamlar kullanmanızı öneririz.

E-Tablolar API'si aşağıdaki kapsamları destekler:

Kapsam kodu Açıklama Kullanım
https://www.googleapis.com/auth/spreadsheets Google E-Tablolar'daki tüm e-tablolarınızı görme, düzenleme, oluşturma ve silme Hassas
https://www.googleapis.com/auth/spreadsheets.readonly Google E-Tablolar'daki tüm e-tablolarınızı görme Hassas
https://www.googleapis.com/auth/drive.file Yalnızca bu uygulamayla kullandığınız Google Drive dosyalarını görme, düzenleme, oluşturma ve silme Önerilir
Hassas olmayan
https://www.googleapis.com/auth/drive Tüm Google Drive dosyalarınızı görün, düzenleyin, oluşturun ve silin. 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 bir kapsamın hassasiyetini gösterir:

  • Hassas olmayan: Bu kapsamlar, en küçük yetkilendirme erişimi kapsamını sağlar ve yalnızca temel düzeyde uygulama doğrulaması gerektirir. Bu şart hakkında bilgi edinmek için Uygulamanızı doğrulamaya gönderme başlıklı makaleyi inceleyin.

  • Hassas: Bu kapsamlar, uygulamanız için kullanıcı tarafından yetkilendirilmiş belirli Google Kullanıcı Verilerine erişim sağlar. Bu kapsamlar için ek uygulama doğrulamasından geçmeniz gerekir. Bu şart hakkında bilgi edinmek için Hassas ve Kısıtlanmış Kapsam Koşulları 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 şart hakkında bilgi edinmek için Google API Hizmetleri Kullanıcı Verileri Politikası'nı ve Belirli API Kapsamları İçin Ek Gereksinimler'i inceleyin. Kısıtlanmış kapsam verilerini sunucularda depoluyorsanız (veya iletiyorsanız) güvenlik değerlendirmesinden geçmeniz gerekir.

Uygulamanız başka Google API'lerine erişim gerektiriyorsa bu kapsamları da ekleyebilirsiniz. Google API kapsamları hakkında daha fazla bilgi için Google API'lerine erişmek iç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.