ภาพรวมของ Directory API
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
Directory API เป็นส่วนหนึ่งของ RESTful Admin SDK API ที่ใช้เพื่อสร้างและจัดการทรัพยากรที่ผู้ดูแลระบบควบคุมซึ่งบัญชี Google Workspace เป็นเจ้าของได้แบบเป็นโปรแกรม กรณีการใช้งานบางส่วนมีดังนี้
- การสร้างและจัดการผู้ใช้ รวมถึงการเพิ่มผู้ดูแลระบบ
- การสร้างและจัดการกลุ่มและการเป็นสมาชิกกลุ่ม
- การตรวจสอบอุปกรณ์ที่เชื่อมต่อกับโดเมนและการดำเนินการกับอุปกรณ์ที่สูญหาย
- การจัดการแผนผังองค์กรและโครงสร้างองค์กร
- ตรวจสอบแอปพลิเคชันที่ผู้ใช้ให้สิทธิ์เข้าถึงและเพิกถอน
แอปที่ไม่ได้รับอนุญาต
ต่อไปนี้คือรายการคำศัพท์ที่ใช้กันโดยทั่วไปใน Directory API
- ลูกค้า
- นิติบุคคลที่เป็นเจ้าของบัญชี Google Workspace ซึ่งแสดงโดยแหล่งข้อมูล
ลูกค้า
- โดเมน
- หากมี โดเมน DNS ที่เชื่อมโยงกับบัญชี Google Workspace
ซึ่งแสดงโดยทรัพยากรโดเมน ไม่ใช่ทุกบัญชี
ที่จะมีโดเมนที่เชื่อมโยง
- หน่วยขององค์กร (OU)
- หน่วยย่อยของโครงสร้างองค์กรของบัญชี Google Workspace ซึ่งใช้เพื่อจัดกลุ่มและจัดเรียงผู้ใช้เพื่อวัตถุประสงค์ในการใช้
นโยบายและให้สิทธิ์
การให้สิทธิ์ OU แสดงโดยทรัพยากร OrgUnit
- สิทธิ์
- ความสามารถของผู้ใช้ในการดำเนินการกับทรัพยากร Google Workspace
ใช้กับผู้ดูแลระบบเป็นหลัก สิทธิ์จะแสดงโดยทรัพยากร
Privilege
- Role
- ชุดสิทธิ์ที่กำหนดไว้ซึ่งสามารถมอบหมายให้กับผู้ใช้หรือชุดผู้ใช้ โดยแสดงด้วยทรัพยากรบทบาท
- การมอบหมายบทบาท
- บันทึกที่ระบุว่าผู้ใช้รายใดได้รับบทบาทใดและมีขอบเขตใด
การมอบหมายบทบาทแสดงโดยทรัพยากร
RoleAssignment
- สคีมา
- ออบเจ็กต์ JSON ที่กำหนดแอตทริบิวต์ผู้ใช้ที่กำหนดเองสำหรับองค์กรของคุณ
ซึ่งแสดงโดยทรัพยากร Schema
- ผู้ใช้
- บัญชีผู้ใช้ปลายทางแต่ละบัญชีที่มีสิทธิ์เข้าถึงแอปและ
ทรัพยากรของ Google Workspace ซึ่งแสดงโดยทรัพยากรผู้ใช้
ขั้นตอนถัดไป
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 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)."]]