Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Masz 5 minut?
Pomóż nam ulepszyć dokumentację Google Workspace, wypełniając krótką ankietę online.
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
Więcej informacji o tworzeniu aplikacji za pomocą interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Pierwsze kroki jako deweloper Google Workspace.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["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)."]]
