Google Drive Etiketler API kapsamlarını seçin

Bu belgede, Drive Labels 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 izin ekranını yapılandırın ve kapsamları seçin. Ayrıca, uygulamanızı daha sonra yayınlayabilmek için kaydedin.

Google Drive Labels API kapsamları

Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını belirleyip beyan etmeniz 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 işlevlerle sınırladığı için hassas olmayan kapsamları kullanmanızı öneririz.

Herkese açık uygulamanız, belirli kullanıcı verilerine erişime izin veren kapsamlar kullanıyorsa doğrulama sürecini tamamlaması gerekir. Uygulamanızı test ederken ekranda doğrulanmamış uygulama ifadesini görüyorsanız bu ifadeyi kaldırmak için doğrulama isteği göndermeniz gerekir. Doğrulanmamış uygulamalar hakkında daha fazla bilgi edinin ve Yardım Merkezi'nde uygulama doğrulama ile ilgili sık sorulan soruların yanıtlarını öğrenin.

Aşağıdaki OAuth 2.0 kapsamları, Drive öğelerine uygulanan etiket meta verilerini okumak, aramak ve değiştirmek için kullanılabilir:

Kapsam	Anlamı
https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata	Drive öğelerine uygulanan etiket meta verilerini okuma, arama ve değiştirme
https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly	Uygulama için yetkilendirilmiş Drive öğelerine uygulanan etiket meta verilerini okuma ve arama

Daha fazla bilgi için Drive API OAuth 2.0 Kapsamları ve Drive API'ye özel yetkilendirme başlıklı makaleleri inceleyin.

Etiketlerin kapsamları

Etiketleri görüntülemek ve yönetmek için aşağıdaki OAuth kapsamları kullanılabilir:

Kapsam	Anlamı
https://www.googleapis.com/auth/drive.labels	Drive etiketlerini görüntüleme, kullanma ve yönetme Bu kapsam, kullanıcı erişimine izin verir ve use_admin_access ayarlanmadığında yazma işlemleri için gereklidir. Bu kapsamdaki yazma işlemleri, SHARED etiket türüne sahip etiketler için geçerlidir.
https://www.googleapis.com/auth/drive.labels.readonly	Drive etiketlerini görüntüleme ve kullanma Bu kapsam, kullanıcı erişimine izin verir ve use_admin_access ayarlanmadığında okuma işlemleri için gereklidir.
https://www.googleapis.com/auth/drive.admin.labels	Kuruluşunuzdaki tüm Drive etiketlerini görüntüleme, düzenleme, oluşturma, silme ve kuruluşunuzun etiketle ilgili yönetim politikalarını görüntüleme Bu kapsam, yönetici erişimine izin verir ve use_admin_access ayarlandığında yazma işlemleri için gereklidir. Bu kapsam, okuma erişimi de verir. Bu kapsamdaki yazma işlemleri, SHARED veya ADMIN etiket türüne sahip etiketler için geçerlidir.
https://www.googleapis.com/auth/drive.admin.labels.readonly	Kuruluşunuzdaki tüm Drive etiketlerini ve etiketle alakalı yönetim politikalarını görüntüleme Bu kapsam, yönetici erişimine izin verir ve use_admin_access ayarlandığında okuma işlemleri için gereklidir.

Yönetici erişimi

Not: EDITOR LabelRole ADMIN etiketleriyle kullanılamaz. ADMIN etiketlerini yönetmek için yönetici ayrıcalıkları gerekir.

ADMIN etiketlerini yönetmek için şunları belirtmeniz gerekir:

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true.
• Etiketleri Yönetme ayrıcalığına sahip hesap yöneticileri.

useAdminAccess

Yöneticiler, yönetici ayrıcalıklarını kullanmak için useAdminAccess parametresini ayarlamalıdır. useAdminAccess ayarı, müşteriye ait tüm etiketlerin görüntülenmesine ve düzenlenmesine olanak tanır. Buna hem ADMIN hem de SHARED etiketleri dahildir.

useAdminAccess ayarlanmadığında yazma isteklerine yalnızca hem SHARED label type olan etiketler hem de bu etiket için uygun EDITOR rolüne sahip kullanıcılar için izin verilir.

Daha fazla bilgi için Erişim kimlik bilgileri oluşturma başlıklı makaleyi inceleyin.