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

Google Drive Labels 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 de 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 işlevlere erişimi daralttığı için hassas olmayan kapsamlar kullanmanızı öneririz.

Herkese açık uygulamanız belirli kullanıcı verilerine erişime izin veren kapsamlar kullanıyorsa bir doğrulama sürecini tamamlamalıdır. Uygulamanızı test ederken ekranda doğrulanmamış uygulama ifadesini görürseniz 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ı bulun.

Etiket meta verilerinin uygulandığı Drive öğelerini okumak, aramak ve değiştirmek için aşağıdaki OAuth 2.0 kapsamları 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 okuyabilir ve arayabilirsiniz.

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 ayarlanmamışsa 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üleyebilir ve kullanabilirsiniz. Bu kapsam, kullanıcı erişimine izin verir ve use_admin_access ayarlanmamışsa okuma işlemleri için gereklidir.
https://www.googleapis.com/auth/drive.admin.labels	Kuruluşunuzdaki tüm Drive etiketlerini görüntüleyebilir, düzenleyebilir, oluşturabilir ve silebilir, ayrıca kuruluşunuzun etiketlerle ilgili yönetim politikalarını görüntüleyebilirsiniz. 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 etiketlerini yönetmek için yönetici ayrıcalıkları gerekir.

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

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true olmalıdır.
• 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 içeren 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.