Google Drive Etiketler API kapsamlarını seçin

Bu belgede, Drive Etiketler API'ye özel yetkilendirme ve kimlik doğrulama bilgileri bulunmaktadır. Bu belgeyi okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi edinme başlıklı makaleden Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okumayı unutmayın.

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

Kullanıcılara ve uygulama inceleme uzmanlarına hangi bilgilerin gösterileceğini tanımlamak için OAuth izin ekranını yapılandırın ve kapsamları seçin. Daha sonra yayınlayabilmek için uygulamanızı kaydedin.

Google Drive Etiketler 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 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. Genellikle, mümkün olan en dar kapsamlı olarak odaklanmış kapsamı seçmeniz ve uygulamanızın gerektirmediği kapsamları istemekten kaçınmanız gerekir. Kullanıcılar sınırlı ve açıkça tanımlanmış kapsamlara daha kolay bir şekilde erişim izni verir.

Mümkün olduğunda, dosya başına erişim kapsamı verdiği ve bir uygulamanın ihtiyaç duyduğu belirli işlevlere erişimi daralttığı için hassas olmayan kapsamların kullanılmasını öneririz.

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

Aşağıdaki OAuth 2.0 kapsamları, etiket meta verilerine uygulanan Drive öğelerini 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 etiketi meta verilerini okuma ve arama.

Daha fazla bilgi edinmek için Drive API OAuth 2.0 Kapsamları ve Drive API'ye özel yetkilendirme başlıklı makalelere bakın.

Etiket kapsamları

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

Kapsam	Anlamı
https://www.googleapis.com/auth/drive.labels	Drive etiketlerini görüntüleyin, kullanın ve yönetin. Bu kapsam, kullanıcı erişimine izin verir ve use_admin_access ayarlanmadığında yazma işlemleri için gereklidir. Bu kapsama sahip 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üleyin ve kullanın. 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 alakalı 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 kapsama sahip 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 ilgili yönetim politikalarını görüntüleyin. 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 etiketi yönetmek için yönetici ayrıcalıkları gereklidir.

ADMIN etiketlerini yönetmek için aşağıdakileri belirtmeniz gerekir:

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

useAdminAccess

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

useAdminAccess ayarlanmadığında yazma isteklerine yalnızca hem SHARED label type 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ı makaleye bakın.