Bu belgede, Directory API'ye özel yetkilendirme ve kimlik doğrulama bilgileri bulunmaktadır. Bu dokümanı okumadan önce, Kimlik doğrulama ve yetkilendirme hakkında bilgi edinin 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.
Directory 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. Genel olarak, 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.
Directory API aşağıdaki kapsamları destekler:
| Cihazlar için kapsamlar | Anlamı |
|---|---|
https://www.googleapis.com/auth/admin.directory.device.chromeos |
Tüm Chrome cihaz işlemlerine erişim için genel kapsam. |
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly |
Yalnızca Chrome cihazları almak için kapsam. |
https://www.googleapis.com/auth/admin.directory.device.mobile |
Tüm mobil cihaz işlemlerine erişim için genel kapsam. |
https://www.googleapis.com/auth/admin.directory.device.mobile.readonly |
Yalnızca mobil cihazı almak için 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 üyesi rollerini ve bilgilerini almak için geçerli olan kapsam. |
https://www.googleapis.com/auth/admin.directory.group |
Grup takma adları ve üyeleri dahil tüm grup işlemlerine erişim için global kapsam. |
https://www.googleapis.com/auth/admin.directory.group.readonly |
Yalnızca grup, grup takma adı ve üye bilgilerini almak için geçerlidir. |
| 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 almak için kullanılan 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ı almak için 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ı almak için 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 kapsamları | Anlamı |
https://www.googleapis.com/auth/admin.directory.rolemanagement |
Rol oluşturma ve rol atama işlemleri dahil olmak üzere tüm rol yönetimi işlemlerinin kapsamı. |
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly |
Rolleri, ayrıcalıkları ve rol atamalarını alma ve listeleme kapsamı. |
| Özel kullanıcı şemalarının kapsamları | Anlamı |
https://www.googleapis.com/auth/admin.directory.userschema |
Tüm özel kullanıcı şeması işlemlerine erişim 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 almak için kapsam. |
| Alanlar için kapsamlar | Anlamı |
https://www.googleapis.com/auth/admin.directory.domain |
Tüm alan işlemlerine erişim kapsamı. |
https://www.googleapis.com/auth/admin.directory.domain.readonly |
Yalnızca alanları almak için 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ı almak için kapsam. |