Google Sheets API kapsamlarını seçme

Bu dokümanda, 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 edinme başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuyun.

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 beyan etmeniz 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 dahil olmak üzere Google Workspace verileriyle çalışma istekleridir.

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 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örebilirsiniz. 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.