Directory API の概要
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Directory API は RESTful Admin SDK API の一部であり、Google Workspace アカウントが所有する管理者制御リソースをプログラムで作成、管理するために使用できます。ユースケースには、次のようなものがあります。
- ユーザーの作成と管理、管理者の追加。
- グループとグループ メンバーの作成と管理。
- ドメインに接続されているデバイスの監視、紛失したデバイスに対するアクションの実行。
- 組織図と組織構造の管理。
- ユーザーがアクセス権を付与したアプリケーションの監査、許可されていないアプリの取り消し。
Directory API で使用される一般的な用語を以下に示します。
- お客様
- Google Workspace アカウントを所有するエンティティ。Customer リソースで表されます。
- ドメイン
- 該当する場合、Google Workspace アカウントに関連付けられている DNS ドメイン。Domain リソースで表されます。すべてのアカウントにドメインが関連付けられているわけではありません。
- 組織部門（OU）
- Google Workspace アカウントの組織ツリーのサブユニット。ポリシーを適用して承認を付与する目的でユーザーをグループ化して分類するために使用されます。OU は OrgUnit リソースで表されます。
- 権限
- ユーザーが Google Workspace のリソースに対してアクションを実行できる能力。
主に管理者に適用されます。権限は Privilege リソースで表されます。
- 職務
- ユーザーまたはユーザーの集団に割り当てることができる権限の定義済みコレクション。Role リソースで表されます。
- ロールの割り当て
- どのユーザーにどのようなロールがどのようなスコープで付与されているかを示すレコード。ロールの割り当ては RoleAssignment リソースで表されます。
- スキーマ
- 組織のカスタム ユーザー属性を定義する JSON オブジェクト。Schema リソースで表されます。
- ユーザー
- Google Workspace のアプリとリソースへのアクセス権を持つ個々のエンドユーザー アカウント。User リソースで表されます。
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-29 UTC。
[null,null,["最終更新日 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)."]]
