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