Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
5 dakikanız var mı?
Kısa bir online ankete katılarak Google Workspace dokümanlarımızı iyileştirmemize yardımcı olun.
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.
Google Workspace uygulamalarına ve kaynaklarına erişimi olan, User kaynağıyla temsil edilen bireysel bir son kullanıcı hesabı.
Sonraki adımlar
Kimlik doğrulama ve yetkilendirme işlemleri de dahil olmak üzere Google Workspace API'leriyle geliştirme hakkında bilgi edinmek için Workspace geliştiricisi olarak kullanmaya başlama başlıklı makaleyi inceleyin.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["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)."]]
