Bu belge, Directory API'ye ö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.
Directory 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.
Directory API aşağıdaki kapsamları destekler:
| Cihaz kapsamları | Anlamı |
|---|---|
https://www.googleapis.com/auth/admin.directory.device.chromeos |
Tüm Chrome cihaz işlemlerine erişim için global kapsam. |
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly |
Yalnızca Chrome cihazlarını alma kapsamı. |
https://www.googleapis.com/auth/admin.directory.device.mobile |
Tüm mobil cihaz işlemlerine erişim için global kapsam. |
https://www.googleapis.com/auth/admin.directory.device.mobile.readonly |
Yalnızca mobil cihazı alma kapsamı |
https://www.googleapis.com/auth/admin.directory.device.mobile.action |
Mobil cihazda işlem yapan görevlerin kapsamı. |
| Gruplar, grup takma adları ve grup üyeleri için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.group.member |
Tüm grup üyesi rollerine ve bilgi işlemlerine erişim kapsamı. |
https://www.googleapis.com/auth/admin.directory.group.member.readonly |
Yalnızca grup üyelerinin rol ve bilgilerini alma kapsamı. |
https://www.googleapis.com/auth/admin.directory.group |
Grup takma adları ve üyeler dahil olmak üzere tüm grup işlemlerine erişim için genel kapsam. |
https://www.googleapis.com/auth/admin.directory.group.readonly |
Yalnızca grup, grup takma adı ve üye bilgilerini almak için kapsam. |
| Kuruluş birimleri için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.orgunit |
Tüm kuruluş birimi işlemlerine erişim için genel kapsam. |
https://www.googleapis.com/auth/admin.directory.orgunit.readonly |
Yalnızca kuruluş birimlerini alma kapsamı. |
| Kullanıcılar ve kullanıcı takma adları için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.user |
Tüm kullanıcı ve kullanıcı takma adı işlemlerine erişim için genel kapsam. |
https://www.googleapis.com/auth/admin.directory.user.readonly |
Yalnızca kullanıcıları veya kullanıcı takma adlarını alma kapsamı. |
https://www.googleapis.com/auth/admin.directory.user.alias |
Tüm kullanıcı takma adı işlemlerine erişim kapsamı. |
https://www.googleapis.com/auth/admin.directory.user.alias.readonly |
Yalnızca kullanıcı takma adlarını alma kapsamı. |
| Kullanıcı güvenlik özellikleri için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.user.security |
Uygulamaya özel tüm şifre, OAuth jetonu ve doğrulama kodu işlemlerine erişim kapsamı. |
| Rol yönetimi için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.rolemanagement |
Roller oluşturma ve rol atamaları da dahil olmak üzere tüm rol yönetimi işlemlerinin kapsamıdır. |
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly |
Roller, ayrıcalıklar ve rol atamalarını alma ve listeleme kapsamı. |
| Özel kullanıcı şemaları için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.userschema |
Tüm özel kullanıcı şeması işlemlerine erişimin kapsamı. |
https://www.googleapis.com/auth/admin.directory.userschema.readonly |
Yalnızca özel kullanıcı şemalarını alma kapsamı. |
| Müşteriler için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.customer |
Tüm müşteri işlemlerine erişim kapsamı. |
https://www.googleapis.com/auth/admin.directory.customer.readonly |
Yalnızca müşterileri alma kapsamı. |
| Alanlar için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.domain |
Tüm alan adı işlemlerine erişim kapsamı. |
https://www.googleapis.com/auth/admin.directory.domain.readonly |
Yalnızca alanları alma kapsamı. |
| Takvim kaynakları için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.resource.calendar |
Tüm takvim kaynakları işlemlerine erişim kapsamı. |
https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly |
Yalnızca takvim kaynaklarını alma kapsamı. |