Admin SDK: Directory API

借助 Admin SDK Directory API,企业网域的管理员可以查看和管理其组织的用户、群组、设备和相关资源。此外,Cloud Identity API 还提供其他管理部分资源的方法。

服务:admin.googleapis.com

要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用程序需要使用自己的库来调用此服务,请在发出 API 请求时使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是指定 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 操作系统设备的属性。
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
检索某个帐号中的 Chrome 操作系统设备的分页列表。
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
将多台 Chrome 操作系统设备移动或插入一个组织部门。
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
更新设备的可更新属性,例如 annotatedUserannotatedLocationnotesorgUnitPathannotatedAssetId
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
更新设备的可更新属性,例如 annotatedUserannotatedLocationnotesorgUnitPathannotatedAssetId

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
检索所有 rolesAssignment 的分页列表。

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
为用户停用两步验证。

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
使用户退出所有网络会话和设备会话,并重置其登录 Cookie。
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
返回指定用户的当前有效备用验证码。