Admin SDK: Directory API

Admin SDK Directory API ช่วยให้ผู้ดูแลระบบของโดเมนองค์กรดูและจัดการผู้ใช้ กลุ่ม อุปกรณ์ และทรัพยากรที่เกี่ยวข้องขององค์กรได้ Cloud Identity API มีวิธีอื่นๆ ในการจัดการทรัพยากรเดียวกันบางส่วน

บริการ: admin.googleapis.com

หากต้องการเรียกใช้บริการนี้ เราขอแนะนำให้คุณใช้ไลบรารีไคลเอ็นต์ที่ Google มีให้ หากแอปพลิเคชันของคุณต้องใช้ไลบรารีของคุณเองเพื่อเรียกใช้บริการนี้ ให้ใช้ข้อมูลต่อไปนี้เมื่อส่งคำขอ API

เอกสารการค้นพบ

เอกสาร Discovery คือข้อกำหนดเฉพาะที่เครื่องอ่านได้สำหรับอธิบายและใช้ REST API โดยใช้ในการสร้างไลบรารีของไคลเอ็นต์ ปลั๊กอิน IDE และเครื่องมืออื่นๆ ที่โต้ตอบกับ Google API บริการหนึ่งๆ อาจให้เอกสารการค้นพบได้หลายรายการ บริการนี้มีเอกสารการค้นพบต่อไปนี้

ปลายทางของบริการ

ปลายทางบริการคือ URL พื้นฐานที่ระบุที่อยู่เครือข่ายของบริการ API บริการหนึ่งๆ อาจมีปลายทางบริการหลายรายการ บริการนี้มีปลายทางบริการดังต่อไปนี้ และ URI ทั้งหมดด้านล่างจะเกี่ยวข้องกับปลายทางบริการนี้

  • https://admin.googleapis.com

ทรัพยากร REST: asps

เมธอด
delete DELETE /admin/directory/v1/users/{userKey}/asps/{codeId}
ลบ ASP ที่ผู้ใช้ออก
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
รับข้อมูลเกี่ยวกับ ASP ที่ผู้ใช้ออก
list GET /admin/directory/v1/users/{userKey}/asps
แสดงรายการ ASP ที่ผู้ใช้ออก

ทรัพยากร REST: chromeosdevices

เมธอด
action
(deprecated)		 POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
ใช้ BatchChangeChromeOsDeviceStatus แทน
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
เรียกข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์ Chrome OS
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
เรียกข้อมูลรายการอุปกรณ์ Chrome OS ภายในบัญชีแบบแบ่งหน้า
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
ย้ายหรือแทรกอุปกรณ์ Chrome OS หลายเครื่องไปยังหน่วยขององค์กร
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
อัปเดตพร็อพเพอร์ตี้ที่อัปเดตได้ของอุปกรณ์ เช่น annotatedUser, annotatedLocation, notes, orgUnitPath หรือ annotatedAssetId
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
อัปเดตพร็อพเพอร์ตี้ที่อัปเดตได้ของอุปกรณ์ เช่น annotatedUser, annotatedLocation, notes, orgUnitPath หรือ annotatedAssetId

ทรัพยากร REST: customer.devices.chromeos

เมธอด
batchChangeStatus POST /admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
เปลี่ยนสถานะของอุปกรณ์ ChromeOS หลายเครื่องพร้อมกัน
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
ส่งคําสั่งให้อุปกรณ์ดําเนินการ

ทรัพยากร REST: customer.devices.chromeos.commands

เมธอด
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
รับข้อมูลคําสั่งที่ส่งไปยังอุปกรณ์

ทรัพยากร REST: customers

เมธอด
get GET /admin/directory/v1/customers/{customerKey}
ดึงข้อมูลลูกค้า
patch PATCH /admin/directory/v1/customers/{customerKey}
แก้ไขลูกค้า
update PUT /admin/directory/v1/customers/{customerKey}
อัปเดตลูกค้า

ทรัพยากร REST: domainAliases

เมธอด
delete DELETE /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
ลบชื่อแทนโดเมนของลูกค้า
get GET /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
เรียกข้อมูลชื่อแทนโดเมนของลูกค้า
insert POST /admin/directory/v1/customer/{customer}/domainaliases
แทรกชื่อแทนโดเมนของลูกค้า
list GET /admin/directory/v1/customer/{customer}/domainaliases
แสดงรายการชื่อแทนโดเมนของลูกค้า

ทรัพยากร REST: domains

เมธอด
delete DELETE /admin/directory/v1/customer/{customer}/domains/{domainName}
ลบโดเมนของลูกค้า
get GET /admin/directory/v1/customer/{customer}/domains/{domainName}
ดึงข้อมูลโดเมนของลูกค้า
insert POST /admin/directory/v1/customer/{customer}/domains
แทรกโดเมนของลูกค้า
list GET /admin/directory/v1/customer/{customer}/domains
แสดงรายการโดเมนของลูกค้า

ทรัพยากร REST: groups

เมธอด
delete DELETE /admin/directory/v1/groups/{groupKey}
ลบกลุ่ม
get GET /admin/directory/v1/groups/{groupKey}
เรียกข้อมูลพร็อพเพอร์ตี้ของกลุ่ม
insert POST /admin/directory/v1/groups
สร้างกลุ่ม
list GET /admin/directory/v1/groups
ดึงข้อมูลกลุ่มทั้งหมดของโดเมนหรือของผู้ใช้ที่ได้รับ userKey (แบ่งเป็นหน้า)
patch PATCH /admin/directory/v1/groups/{groupKey}
อัปเดตพร็อพเพอร์ตี้ของกลุ่ม
update PUT /admin/directory/v1/groups/{groupKey}
อัปเดตพร็อพเพอร์ตี้ของกลุ่ม

ทรัพยากร REST: groups.aliases

เมธอด
delete DELETE /admin/directory/v1/groups/{groupKey}/aliases/{alias}
นำชื่อแทนออก
insert POST /admin/directory/v1/groups/{groupKey}/aliases
เพิ่มชื่อแทนสำหรับกลุ่ม
list GET /admin/directory/v1/groups/{groupKey}/aliases
แสดงอีเมลแทนทั้งหมดของกลุ่ม

ทรัพยากร REST: members

เมธอด
delete DELETE /admin/directory/v1/groups/{groupKey}/members/{memberKey}
นำสมาชิกออกจากกลุ่ม
get GET /admin/directory/v1/groups/{groupKey}/members/{memberKey}
เรียกข้อมูลพร็อพเพอร์ตี้ของสมาชิกกลุ่ม
hasMember GET /admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
ตรวจสอบว่าผู้ใช้ที่ระบุเป็นสมาชิกของกลุ่มหรือไม่
insert POST /admin/directory/v1/groups/{groupKey}/members
เพิ่มผู้ใช้ลงในกลุ่มที่ระบุ
list GET /admin/directory/v1/groups/{groupKey}/members
ดึงข้อมูลรายการสมาชิกทั้งหมดในกลุ่มแบบแบ่งหน้า
patch PATCH /admin/directory/v1/groups/{groupKey}/members/{memberKey}
อัปเดตพร็อพเพอร์ตี้การเป็นสมาชิกของผู้ใช้ในกลุ่มที่ระบุ
update PUT /admin/directory/v1/groups/{groupKey}/members/{memberKey}
อัปเดตการเป็นสมาชิกของผู้ใช้ในกลุ่มที่ระบุ

ทรัพยากร REST: mobiledevices

เมธอด
action POST /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action
ดำเนินการที่ส่งผลต่ออุปกรณ์เคลื่อนที่
delete DELETE /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
นำอุปกรณ์เคลื่อนที่ออก
get GET /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
ดึงข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์เคลื่อนที่
list GET /admin/directory/v1/customer/{customerId}/devices/mobile
เรียกข้อมูลรายการอุปกรณ์เคลื่อนที่ทั้งหมดที่ผู้ใช้เป็นเจ้าของสำหรับบัญชีหนึ่งๆ โดยแบ่งเป็นหน้า

ทรัพยากร REST: orgunits

เมธอด
delete DELETE /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
นำหน่วยขององค์กรออก
get GET /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
เรียกข้อมูลหน่วยขององค์กร
insert POST /admin/directory/v1/customer/{customerId}/orgunits
เพิ่มหน่วยขององค์กร
list GET /admin/directory/v1/customer/{customerId}/orgunits
ดึงข้อมูลรายการหน่วยขององค์กรทั้งหมดสําหรับบัญชี
patch PATCH /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
อัปเดตหน่วยขององค์กร
update PUT /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
อัปเดตหน่วยขององค์กร

ทรัพยากร REST: privileges

เมธอด
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
เรียกข้อมูลรายการสิทธิ์ทั้งหมดของลูกค้าแบบแบ่งหน้า

ทรัพยากร REST: resources.buildings

เมธอด
delete DELETE /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
ลบอาคาร
get GET /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
ดึงข้อมูลอาคาร
insert POST /admin/directory/v1/customer/{customer}/resources/buildings
แทรกอาคาร
list GET /admin/directory/v1/customer/{customer}/resources/buildings
เรียกข้อมูลรายการอาคารของบัญชี
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
แก้ไขอาคาร
update PUT /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
อัปเดตอาคาร

ทรัพยากร REST: resources.calendars

เมธอด
delete DELETE /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
ลบทรัพยากรในปฏิทิน
get GET /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
เรียกข้อมูลทรัพยากรในปฏิทิน
insert POST /admin/directory/v1/customer/{customer}/resources/calendars
แทรกทรัพยากรในปฏิทิน
list GET /admin/directory/v1/customer/{customer}/resources/calendars
ดึงข้อมูลรายการทรัพยากรในปฏิทินสำหรับบัญชี
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
แก้ไขทรัพยากรในปฏิทิน
update PUT /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
อัปเดตทรัพยากรในปฏิทิน

ทรัพยากร REST: resources.features

เมธอด
delete DELETE /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
ลบฟีเจอร์
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
เรียกข้อมูลฟีเจอร์
insert POST /admin/directory/v1/customer/{customer}/resources/features
แทรกองค์ประกอบ
list GET /admin/directory/v1/customer/{customer}/resources/features
เรียกข้อมูลรายการฟีเจอร์สําหรับบัญชี
patch PATCH /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
แก้ไขข้อบกพร่องของฟีเจอร์
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
เปลี่ยนชื่อองค์ประกอบ
update PUT /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
อัปเดตฟีเจอร์

ทรัพยากร REST: roleAssignments

เมธอด
delete DELETE /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
ลบการมอบหมายบทบาท
get GET /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
เรียกข้อมูลการมอบหมายบทบาท
insert POST /admin/directory/v1/customer/{customer}/roleassignments
สร้างการมอบหมายบทบาท
list GET /admin/directory/v1/customer/{customer}/roleassignments
ดึงข้อมูลรายการ roleAssignment ทั้งหมดแบบแบ่งหน้า

ทรัพยากร REST: roles

เมธอด
delete DELETE /admin/directory/v1/customer/{customer}/roles/{roleId}
ลบบทบาท
get GET /admin/directory/v1/customer/{customer}/roles/{roleId}
ดึงข้อมูลบทบาท
insert POST /admin/directory/v1/customer/{customer}/roles
สร้างบทบาท
list GET /admin/directory/v1/customer/{customer}/roles
ดึงข้อมูลรายการบทบาททั้งหมดในโดเมนแบบแบ่งหน้า
patch PATCH /admin/directory/v1/customer/{customer}/roles/{roleId}
แก้ไขบทบาท
update PUT /admin/directory/v1/customer/{customer}/roles/{roleId}
อัปเดตบทบาท

ทรัพยากร REST: schemas

เมธอด
delete DELETE /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
ลบสคีมา
get GET /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
เรียกข้อมูลสคีมา
insert POST /admin/directory/v1/customer/{customerId}/schemas
สร้างสคีมา
list GET /admin/directory/v1/customer/{customerId}/schemas
ดึงข้อมูลสคีมาทั้งหมดสำหรับลูกค้า
patch PATCH /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
แก้ไขสคีมา
update PUT /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
อัปเดตสคีมา

ทรัพยากร REST: tokens

เมธอด
delete DELETE /admin/directory/v1/users/{userKey}/tokens/{clientId}
ลบโทเค็นการเข้าถึงทั้งหมดที่ผู้ใช้ออกให้แอปพลิเคชัน
get GET /admin/directory/v1/users/{userKey}/tokens/{clientId}
รับข้อมูลเกี่ยวกับโทเค็นการเข้าถึงที่ผู้ใช้ออกให้
list GET /admin/directory/v1/users/{userKey}/tokens
แสดงชุดโทเค็นที่ผู้ใช้ที่ระบุออกให้กับแอปพลิเคชันของบุคคลที่สาม

ทรัพยากร REST: twoStepVerification

เมธอด
turnOff POST /admin/directory/v1/users/{userKey}/twoStepVerification/turnOff
ปิดการยืนยันแบบ 2 ขั้นตอนสำหรับผู้ใช้

ทรัพยากร REST: users

เมธอด
delete DELETE /admin/directory/v1/users/{userKey}
ลบผู้ใช้
get GET /admin/directory/v1/users/{userKey}
ดึงข้อมูลผู้ใช้
insert POST /admin/directory/v1/users
สร้างผู้ใช้
list GET /admin/directory/v1/users
ดึงข้อมูลรายการผู้ใช้ที่ถูกลบหรือผู้ใช้ทั้งหมดในโดเมนแบบแบ่งหน้า
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
กําหนดให้ผู้ใช้เป็นผู้ดูแลระบบขั้นสูง
patch PATCH /admin/directory/v1/users/{userKey}
อัปเดตผู้ใช้โดยใช้ความหมายของแพตช์
signOut POST /admin/directory/v1/users/{userKey}/signOut
นำผู้ใช้ออกจากเซสชันเว็บและอุปกรณ์ทั้งหมด และรีเซ็ตคุกกี้การลงชื่อเข้าใช้
undelete POST /admin/directory/v1/users/{userKey}/undelete
ยกเลิกการลบผู้ใช้ที่ถูกลบ
update PUT /admin/directory/v1/users/{userKey}
อัปเดตผู้ใช้
watch POST /admin/directory/v1/users/watch
คอยตรวจสอบการเปลี่ยนแปลงในรายชื่อผู้ใช้

ทรัพยากร REST: users.aliases

เมธอด
delete DELETE /admin/directory/v1/users/{userKey}/aliases/{alias}
นำชื่อแทนออก
insert POST /admin/directory/v1/users/{userKey}/aliases
เพิ่มอีเมลแทน
list GET /admin/directory/v1/users/{userKey}/aliases
แสดงอีเมลแทนทั้งหมดของผู้ใช้
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
คอยตรวจสอบการเปลี่ยนแปลงในรายชื่อผู้ใช้

ทรัพยากร REST: users.photos

เมธอด
delete DELETE /admin/directory/v1/users/{userKey}/photos/thumbnail
นำรูปภาพของผู้ใช้ออก
get GET /admin/directory/v1/users/{userKey}/photos/thumbnail
ดึงข้อมูลรูปภาพของผู้ใช้
patch PATCH /admin/directory/v1/users/{userKey}/photos/thumbnail
เพิ่มรูปภาพให้ผู้ใช้
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
เพิ่มรูปภาพให้ผู้ใช้

ทรัพยากร REST: verificationCodes

เมธอด
generate POST /admin/directory/v1/users/{userKey}/verificationCodes/generate
สร้างรหัสยืนยันสำรองใหม่ให้ผู้ใช้
invalidate POST /admin/directory/v1/users/{userKey}/verificationCodes/invalidate
ทำให้รหัสยืนยันสำรองปัจจุบันของผู้ใช้ใช้งานไม่ได้
list GET /admin/directory/v1/users/{userKey}/verificationCodes
แสดงชุดรหัสยืนยันสำรองที่ถูกต้องในปัจจุบันสำหรับผู้ใช้ที่ระบุ