Ringkasan Directory API
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Directory API adalah bagian dari RESTful Admin SDK API yang dapat digunakan untuk membuat dan mengelola resource yang dikontrol admin secara terprogram dan dimiliki oleh akun Google Workspace. Beberapa kasus penggunaan mencakup:
- Membuat dan mengelola pengguna serta menambahkan administrator.
- Membuat dan mengelola grup dan keanggotaan grup.
- Memantau perangkat yang terhubung ke domain Anda dan mengambil tindakan pada perangkat yang hilang.
- Mengelola struktur organisasi dan bagan organisasi Anda.
- Mengaudit aplikasi yang telah diberi akses oleh pengguna Anda dan mencabut
aplikasi yang tidak sah.
Berikut adalah daftar istilah umum yang digunakan dalam Directory API:
- Pelanggan
- Entitas yang memiliki akun Google Workspace, yang diwakili oleh resource
Customer.
- Domain
- Jika berlaku, domain DNS yang terkait dengan akun Google Workspace,
diwakili oleh resource
Domain. Tidak semua
akun memiliki domain terkait.
- Unit organisasi (OU)
- Sub-unit struktur organisasi akun Google Workspace, yang digunakan untuk
mengelompokkan dan mengurutkan pengguna untuk tujuan penerapan kebijakan dan pemberian
otorisasi. OU diwakili oleh resource
OrgUnit.
- Hak istimewa
- Kemampuan pengguna untuk melakukan tindakan pada resource Google Workspace.
Terutama berlaku untuk admin. Hak istimewa diwakili oleh
resource
Privilege.
- Jabatan
- Kumpulan hak istimewa yang ditentukan yang dapat ditetapkan kepada pengguna atau sekumpulan
pengguna, yang diwakili oleh resource
Peran.
- Penetapan peran
- Catatan yang menunjukkan pengguna mana yang diberi peran apa, dan dalam cakupan apa.
Penetapan peran diwakili oleh
resource RoleAssignment.
- Skema
- Objek JSON yang menentukan atribut pengguna kustom untuk organisasi Anda, yang diwakili oleh resource
Schema.
- Pengguna
- Akun pengguna akhir perorangan dengan akses ke aplikasi dan
resource Google Workspace, yang diwakili oleh resource
Pengguna.
Langkah berikutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 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)."]]
