Method: users.list

检索已删除用户或网域中所有用户的分页列表。

HTTP 请求

GET https://admin.googleapis.com/admin/directory/v1/users

网址采用 gRPC 转码语法。

查询参数

参数
customFieldMask

string

以英文逗号分隔的架构名称列表。系统将提取这些架构中的所有字段。仅当 projection=custom 时，才应设置此字段。
customer

string

客户的 Google Workspace 帐号的唯一 ID。对于多网域帐号，要提取客户的所有群组，请使用此字段而不是 domain。您还可以使用 my_customer 别名来代表您帐号的 customerId。customerId 也会作为 Users 资源的一部分返回。您必须提供 customer 或 domain 参数。
domain

string

域名。使用此字段获取仅来自一个网域的群组。要返回客户帐号的所有域名，请改用 customer 查询参数。必须提供 customer 或 domain 参数。
event

enum (Event)

打算订阅的事件（如果是订阅）
maxResults

integer

返回的结果数上限。
orderBy

enum (OrderBy)

用于对结果进行排序的属性。
pageToken

string

用于指定列表中下一页的令牌
projection

enum (Projection)

要为此用户提取的字段子集。
query

string

用于搜索用户字段的查询字符串。如需详细了解如何构建用户查询，请参阅搜索用户。
showDeleted

string

如果设置为 true，则检索已删除用户列表。（默认值：false）
sortOrder

enum (SortOrder)

是按升序还是降序返回结果，不区分大小写。
viewType

enum (ViewType)

获取用户的公开视图（仅限管理员视图还是整个网域）。如需了解详情，请参阅以非管理员身份检索用户。

请求正文

请求正文必须为空。

响应正文

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "kind": string,
  "trigger_event": string,
  "etag": string,
  "users": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
字段
kind

string

此资源的种类。
trigger_event

string

触发此响应的事件（仅用于推送响应）
etag

string

资源的 ETag。
users[]

object (User)

User 对象的列表。
nextPageToken

string

用于访问此结果下一页的令牌。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.readonly
  • https://www.googleapis.com/auth/cloud-platform

有关详情，请参阅授权指南。

事件

订阅事件类型

枚举
ADD 用户创建的事件
DELETE 用户删除活动
MAKE_ADMIN 用户管理员状态更改事件
UNDELETE 用户取消删除的活动
UPDATE 用户更新的活动

OrderBy

枚举
EMAIL 用户的主电子邮件地址。
FAMILY_NAME 用户的姓氏。
GIVEN_NAME 用户的名字。

Projection

枚举
BASIC 请勿添加该用户的任何自定义字段。
CUSTOM 包含 customFieldMask 中所请求的架构中的自定义字段。
FULL 包含与此用户关联的所有字段。

SortOrder

枚举
ASCENDING 升序。
DESCENDING 降序。

ViewType

枚举
admin_view 结果包含用户的仅限管理员字段和网域公共字段。
domain_public 结果仅包含网域中的其他用户公开显示的用户字段。