Directory API'ye Genel Bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Directory API, bir Google Workspace hesabına ait yönetici denetimindeki kaynakları programatik olarak oluşturmak ve yönetmek için kullanılabilecek RESTful Admin SDK API'nin bir parçasıdır. Bazı kullanım alanları:
- Kullanıcı oluşturma ve yönetme, yönetici ekleme
- Grup ve grup üyelikleri oluşturma ve yönetme
- Alanınıza bağlı cihazları izleme ve kayıp cihazlarla ilgili işlem yapma
- Kuruluş şemanızı ve kuruluş yapılarınızı yönetme
- Kullanıcılarınızın erişim izni verdiği uygulamaları denetleme ve yetkisiz uygulamaları iptal etme
Directory API'de kullanılan yaygın terimlerin listesi aşağıda verilmiştir:
- Müşteri
- Google Workspace hesabının sahibi olan tüzel kişi. Müşteri kaynağıyla temsil edilir.
- Alan
- Varsa Domain kaynağıyla temsil edilen bir Google Workspace hesabıyla ilişkili DNS alanı. Tüm hesapların ilişkili bir alanı yoktur.
- Kuruluş birimi (OU)
- Politika uygulamak ve yetki vermek amacıyla kullanıcıları gruplandırmak ve sıralamak için kullanılan, Google Workspace hesabının kuruluş ağacındaki bir alt birim. Kuruluş birimi, OrgUnit kaynağıyla temsil edilir.
- Ayrıcalık (Privilege)
- Kullanıcının Google Workspace kaynağında işlem yapabilme özelliği.
Öncelikle yöneticiler için geçerlidir. Ayrıcalıklar Privilege kaynağıyla temsil edilir.
- Rol
- Bir kullanıcıya veya kullanıcı grubuna atanabilen, Role kaynağıyla temsil edilen tanımlı ayrıcalıklar koleksiyonu.
- Rol atama
- Hangi kullanıcıya hangi rollerin ve hangi kapsamda verildiğini gösteren bir kayıt.
Rol ataması, RoleAssignment kaynağıyla temsil edilir.
- Şema
- Kuruluşunuz için özel kullanıcı özelliklerini tanımlayan bir JSON nesnesi.
Şema kaynağıyla temsil edilir.
- Kullanıcı
- Google Workspace uygulamalarına ve kaynaklarına erişimi olan, User kaynağıyla temsil edilen bireysel bir son kullanıcı hesabı.
Sonraki adımlar
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Directory API Overview\n\n|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\n\nThe Directory API is part of the RESTful Admin SDK API that can be used to\nprogrammatically create and manage admin-controlled resources owned by a\nGoogle Workspace account. Some use cases include:\n\n- Creating and managing users and adding administrators.\n- Creating and managing groups and group memberships.\n- Monitoring devices connected to your domain and taking action on lost devices.\n- Managing your org chart and organization structures.\n- Auditing applications your users have granted access to and revoking unauthorized apps.\n\nFollowing is a list of common terms used in the Directory API:\n\n*Customer*\n: The entity that owns the Google Workspace account, represented by the\n [Customer](/workspace/admin/directory/reference/rest/v1/customers) resource.\n\n*Domain*\n: If applicable, the DNS domain associated with a Google Workspace account,\n represented by the\n [Domain](/workspace/admin/directory/reference/rest/v1/domains) resource. Not all\n accounts have an associated domain.\n\n*Organizational unit (OU)*\n: A sub-unit of a Google Workspace account's organizational tree, used to\n group and sort users for the purpose of applying policies and granting\n authorizations. An OU is represented by the\n [OrgUnit](/workspace/admin/directory/reference/rest/v1/orgunits) resource.\n\n*Privilege*\n: The ability of a user to perform an action on a Google Workspace resource.\n Applies primarily to admins. A privilege is represented by the\n [Privilege](/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege)\n resource.\n\n*Role*\n: A defined collection of privileges that can be assigned to a user or set of\n users, represented by the\n [Role](/workspace/admin/directory/reference/rest/v1/roles) resource.\n\n*Role assignment*\n: A record indicating which user is granted what roles, and over what scope.\n A role assignment is represented by the\n [RoleAssignment](/workspace/admin/directory/reference/rest/v1/roleAssignments)\n resource.\n\n*Schema*\n: A JSON object that defines custom user attributes for your organization,\n represented by the\n [Schema](/workspace/admin/directory/reference/rest/v1/schemas) resource.\n\n*User*\n: An individual end user account with access to Google Workspace apps and\n resources, represented by the\n [User](/workspace/admin/directory/reference/rest/v1/users) resource.\n\nNext steps\n----------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to\n [Get started as a Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Directory API app, try the\n [JavaScript quickstart](/workspace/admin/directory/v1/quickstart/js)."]]
