Omówienie interfejsu Directory API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs Directory API jest częścią interfejsu Admin SDK API w formacie REST, którego można używać do automatycznego tworzenia zasobów kontrolowanych przez administratora i zarządzania nimi. Te zasoby należą do konta Google Workspace. Przykłady zastosowań:
- tworzenie kont użytkowników i zarządzanie nimi oraz dodawanie administratorów;
- tworzenie grup i zarządzanie nimi oraz członkostwem w grupach;
- monitorowanie urządzeń połączonych z Twoją domeną i podejmowanie działań w przypadku utraty urządzeń;
- zarządzanie schematem organizacyjnym i strukturami organizacji;
- Sprawdzanie aplikacji, którym użytkownicy przyznali dostęp, i cofanie uprawnień nieautoryzowanym aplikacjom.
Poniżej znajdziesz listę typowych terminów używanych w interfejsie Directory API:
- Klient
- Podmiot, który jest właścicielem konta Google Workspace, reprezentowany przez zasób Customer.
- Domena
- W stosownych przypadkach domena DNS powiązana z kontem Google Workspace, reprezentowana przez zasób Domain. Nie wszystkie konta mają powiązaną domenę.
- Jednostka organizacyjna
- Podjednostka drzewa organizacyjnego konta Google Workspace, która służy do grupowania i sortowania użytkowników w celu stosowania zasad i przyznawania uprawnień. Jednostka organizacyjna jest reprezentowana przez zasób OrgUnit.
- Uprawnienie
- Możliwość wykonania przez użytkownika działania na zasobie Google Workspace.
Dotyczy głównie administratorów. Uprawnienie jest reprezentowane przez zasób Privilege.
- Role
- Zdefiniowany zbiór uprawnień, które można przypisać użytkownikowi lub grupie użytkowników. Jest reprezentowany przez zasób Rola.
- Przypisanie roli
- Rekord wskazujący, którym użytkownikom przyznano jakie role i w jakim zakresie.
Przypisanie roli jest reprezentowane przez zasób RoleAssignment.
- Schemat
- Obiekt JSON, który definiuje atrybuty niestandardowe użytkownika w Twojej organizacji, reprezentowany przez zasób Schema.
- Użytkownik
- Konto użytkownika z dostępem do aplikacji i zasobów Google Workspace, reprezentowane przez zasób User.
Dalsze kroki
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
