资源:User
借助 Directory API,您可以创建和管理自己帐号的用户、用户别名以及用户的 Gmail 聊天个人资料照片。有关常见任务的详细信息,请参阅用户帐号开发者指南和《用户别名开发者指南》。
JSON 表示法 |
---|
{
"id": string,
"primaryEmail": string,
"password": value,
"hashFunction": string,
"isAdmin": boolean,
"isDelegatedAdmin": boolean,
"agreedToTerms": boolean,
"suspended": boolean,
"changePasswordAtNextLogin": boolean,
"ipWhitelisted": boolean,
"name": {
object ( |
字段 | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
用户的唯一 ID。用户 |
||||||||||||||||||||||||||||||||||||||||||
primaryEmail |
用户的主电子邮件地址。在创建用户帐号的请求中,此属性是必需的。 |
||||||||||||||||||||||||||||||||||||||||||
password |
存储用户帐号的密码。创建用户帐号时,必须指定用户的密码值。在更新用户时,此为可选项,只有在用户更新帐号密码时才应提供。密码值绝不会在 API 的响应正文中返回。 |
||||||||||||||||||||||||||||||||||||||||||
hashFunction |
存储
如果轮次被指定为前缀的一部分,则不得超过 10000 次。 |
||||||||||||||||||||||||||||||||||||||||||
isAdmin |
仅供输出。表示拥有超级用户权限的用户。只能在让用户成为管理员操作(makeAdmin 方法)中修改 |
||||||||||||||||||||||||||||||||||||||||||
isDelegatedAdmin |
仅供输出。指明用户是否为委派管理员。 |
||||||||||||||||||||||||||||||||||||||||||
agreedToTerms |
仅供输出。如果用户已完成初始登录并接受了《服务条款》协议,则此媒体资源为 |
||||||||||||||||||||||||||||||||||||||||||
suspended |
指明用户是否已暂停。 |
||||||||||||||||||||||||||||||||||||||||||
changePasswordAtNextLogin |
指明是否强制要求用户在下次登录时更改密码。当用户通过第三方身份提供商登录时,此设置不适用。 |
||||||||||||||||||||||||||||||||||||||||||
ipWhitelisted |
如果为 |
||||||||||||||||||||||||||||||||||||||||||
name |
包含用户的指定和系列名称,以及只读 |
||||||||||||||||||||||||||||||||||||||||||
kind |
仅供输出。API 资源类型。对于用户资源,该值为 |
||||||||||||||||||||||||||||||||||||||||||
etag |
仅供输出。资源的 ETag。 |
||||||||||||||||||||||||||||||||||||||||||
emails |
用户的电子邮件地址列表。允许的数据大小上限为 10 KB。
|
||||||||||||||||||||||||||||||||||||||||||
externalIds |
用户的外部 ID(例如员工 ID 或网络 ID)列表。允许的数据大小上限为 2KB。
|
||||||||||||||||||||||||||||||||||||||||||
relations |
用户与其他用户的关系列表。此字段允许的数据大小上限为 2KB。有关详情,请参阅管理用户帐号。
|
||||||||||||||||||||||||||||||||||||||||||
aliases[] |
仅供输出。用户的别名电子邮件地址列表。 |
||||||||||||||||||||||||||||||||||||||||||
isMailboxSetup |
仅供输出。指明是否已创建用户的 Google 邮箱。仅当用户已获得 Gmail 许可时,此属性才适用。 |
||||||||||||||||||||||||||||||||||||||||||
customerId |
仅供输出。用于检索所有帐号用户的客户 ID。 |
||||||||||||||||||||||||||||||||||||||||||
addresses |
用户的地址列表。允许的数据大小上限为 10 KB。
|
||||||||||||||||||||||||||||||||||||||||||
organizations |
用户所属的单位列表。允许的数据大小上限为 10 KB。
|
||||||||||||||||||||||||||||||||||||||||||
lastLoginTime |
仅供输出。用户上次登录用户帐号的时间。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒,格式为 |
||||||||||||||||||||||||||||||||||||||||||
phones |
用户的电话号码列表。允许的数据大小上限为 1KB。
|
||||||||||||||||||||||||||||||||||||||||||
suspensionReason |
仅供输出。拥有管理员在暂停时用户帐号遭到暂停的原因。仅当 |
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoUrl |
仅供输出。用户的照片网址(只读) |
||||||||||||||||||||||||||||||||||||||||||
languages |
用户的语言列表。允许的数据大小上限为 1KB。
|
||||||||||||||||||||||||||||||||||||||||||
posixAccounts |
用户的 POSIX 帐号信息列表。
|
||||||||||||||||||||||||||||||||||||||||||
creationTime |
仅供输出。用户帐号的创建时间。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒,格式为 |
||||||||||||||||||||||||||||||||||||||||||
nonEditableAliases[] |
仅供输出。用户的不可修改的别名电子邮件地址列表。它们通常位于帐号的主网域或子网域之外。 |
||||||||||||||||||||||||||||||||||||||||||
sshPublicKeys |
SSH 公钥列表。
|
||||||||||||||||||||||||||||||||||||||||||
notes |
作为嵌套对象的用户备注。
|
||||||||||||||||||||||||||||||||||||||||||
websites |
用户的网站列表。
|
||||||||||||||||||||||||||||||||||||||||||
locations |
用户的地理位置列表。允许的数据大小上限为 10 KB。
|
||||||||||||||||||||||||||||||||||||||||||
includeInGlobalAddressList |
说明在网域启用了联系人共享功能后,用户个人资料是否会显示在 Google Workspace 全局地址列表中。有关排除用户个人资料的详细信息,请参阅管理帮助中心。 |
||||||||||||||||||||||||||||||||||||||||||
keywords |
用户的关键字列表。允许的数据大小上限为 1KB。
|
||||||||||||||||||||||||||||||||||||||||||
deletionTime |
仅供输出。用户帐号的删除时间。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒,格式为 |
||||||||||||||||||||||||||||||||||||||||||
gender |
包含用户性别的嵌套对象。此字段允许的数据大小上限为 1KB。
|
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoEtag |
仅供输出。用户照片的 ETag(只读) |
||||||||||||||||||||||||||||||||||||||||||
ims |
用户的 Instant Messenger (IM) 帐号。一个用户帐号可以有多个
|
||||||||||||||||||||||||||||||||||||||||||
customSchemas |
用户的自定义字段。键是
|
||||||||||||||||||||||||||||||||||||||||||
isEnrolledIn2Sv |
仅供输出。已注册两步验证(只读) |
||||||||||||||||||||||||||||||||||||||||||
isEnforcedIn2Sv |
仅供输出。是否强制执行两步验证(只读) |
||||||||||||||||||||||||||||||||||||||||||
archived |
指明用户是否已归档。 |
||||||||||||||||||||||||||||||||||||||||||
orgUnitPath |
与用户关联的上级单位的完整路径。如果上级单位是顶级单位,则用正斜线 ( |
||||||||||||||||||||||||||||||||||||||||||
recoveryEmail |
用户的辅助邮箱。 |
||||||||||||||||||||||||||||||||||||||||||
recoveryPhone |
用户的辅助电话号码。电话号码必须采用 E.164 格式,以加号 (+) 开头。示例:+16506661212。 |
用户名
JSON 表示法 |
---|
{ "fullName": string, "familyName": string, "givenName": string, "displayName": string } |
字段 | |
---|---|
fullName |
用户的全名通过串联名字和姓氏值形成。 |
familyName |
用户的姓氏。创建用户帐号时必填。 |
givenName |
用户的名字。创建用户帐号时必填。 |
displayName |
用户的显示名。限制:最多 256 个字符。 |
方法 |
|
---|---|
|
删除用户。 |
|
检索用户。 |
|
创建用户。 |
|
检索删除的用户或域内所有用户的分页列表。 |
|
将用户设为超级用户。 |
|
使用补丁语义更新用户。 |
|
将用户退出所有网页和设备会话,并重置其登录 Cookie。 |
|
恢复删除的用户。 |
|
更新用户。 |
|
监控用户名单的变化。 |