Google Dokümanlar API kapsamlarını seçme

Bu belge, Google Dokümanlar API'sına özel yetkilendirme ve kimlik doğrulama bilgilerini içerir. Bu dokümanı okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi edinin başlıklı makaleden Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuduğunuzdan emin olun.

Yetkilendirme için OAuth 2.0'ı yapılandırın

OAuth izin ekranını yapılandırıp kapsamları seçerek kullanıcılara ve uygulama inceleme uzmanlarına gösterilecek bilgileri tanımlayın ve uygulamanızı daha sonra yayınlayabilmek için kaydedin.

Docs API kapsamları

Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını tanımlamanız ve bildirmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulamasının adını, eriştiği verilerin türünü ve erişim düzeyini içeren bir OAuth 2.0 URI dizesidir. Kapsamlar, uygulamanızın Google Workspace verileriyle (kullanıcıların Google Hesabı verileri dahil) çalışma istekleridir.

Uygulamanız yüklendiğinde kullanıcıdan uygulama tarafından kullanılan kapsamları doğrulaması istenir. Genel olarak, mümkün olan en dar kapsamlı olarak odaklanmış kapsamı seçmeniz ve uygulamanızın gerektirmediği kapsamları talep etmekten kaçınmanız gerekir. Kullanıcılar sınırlı, net bir şekilde açıklanan kapsamlara daha kolay bir şekilde erişim izni verir.

Mümkün olduğunda, dosya başına erişim kapsamı verdiği ve uygulamanın ihtiyaç duyduğu belirli özelliklere erişimi daralttığı 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 Tüm Google Dokümanlar dokümanlarınızı görün, düzenleyin, oluşturun ve silin. Hassas
https://www.googleapis.com/auth/documents.readonly Tüm Google Dokümanlar dokümanlarınızı görüntüleyin. Hassas
https://www.googleapis.com/auth/drive.file Yalnızca bu uygulamayla kullandığınız belirli Google Drive dosyalarını görme, düzenleme, oluşturma ve silme. Önerilen
Hassas değil
https://www.googleapis.com/auth/drive Tüm Google Drive dosyalarınızı görün, düzenleyin, oluşturun ve silin. Kısıtlı
https://www.googleapis.com/auth/drive.readonly Tüm Google Drive dosyalarınızı görün ve indirin. Kısıtlı

Tablodaki Kullanım sütunu, aşağıdaki tanımlara göre her kapsamın hassasiyetini gösterir:

  • Hassas değildir: Bu kapsamlar, en küçük yetkilendirme erişimi kapsamını sağlar ve yalnızca temel uygulama doğrulaması gerektirir. Bu şart hakkında bilgi edinmek için Uygulamanızı doğrulama için gönderme bölümüne bakın.

  • Hassas: Bu kapsamlar, kullanıcının uygulamanız için yetkilendirdiği belirli Google Kullanıcı Verileri'ne erişim sağlar. Ek uygulama doğrulama sürecinden geçmeniz gerekir. Bu koşul hakkında bilgi edinmek için Hassas ve Kısıtlanmış Kapsam Şartları bölümüne bakın.

  • Kısıtlanmış: Bu kapsamlar, Google Kullanıcı Verileri'ne geniş erişim sağlar ve kısıtlanmış bir kapsam doğrulama sürecinden geçmenizi gerektirir. Bu gereksinim hakkında daha fazla bilgi edinmek için Google API Hizmetleri Kullanıcı Verileri Politikası'na ve Belirli API Kapsamları İçin Ek Gereksinimler'e göz atın. Kısıtlanmış kapsam verilerini sunucularda depoluyorsanız (veya iletiyorsanız) bir güvenlik değerlendirmesinden geçmeniz gerekir.

Uygulamanızın başka herhangi bir Google API'sine erişmesi gerekiyorsa 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 bölümüne bakın.

Belirli OAuth 2.0 kapsamları hakkında daha fazla bilgi edinmek için Google API'leri için OAuth 2.0 Kapsamları bölümüne bakın.