Method: people.listDirectoryPeople

提供经过身份验证的用户网域目录中的网域个人资料和网域联系人的列表。

指定 syncToken 后,自上次同步以来删除的资源将作为 PersonMetadata.deleted 设置为 true 的用户返回。

如果指定了 pageTokensyncToken,所有其他请求参数都必须与首次调用匹配。

写入的传播请求可能会延迟几分钟。增量同步不适用于写入后读取的用例。

请参阅列出已更改的目录中的用法示例。

HTTP 请求

GET https://people.googleapis.com/v1/people:listDirectoryPeople

网址采用 gRPC 转码语法。

查询参数

参数
readMask

string (FieldMask format)

必需。一个字段掩码,用于限制返回每个人的字段。您可以指定多个字段,只需用英文逗号分隔即可。有效值包括:

  • addresses
  • ageRanges [年龄段]
  • 传记
  • 生日
  • 日历网址
  • 客户端数据
  • 封面照片
  • emailAddresses
  • events
  • externalId
  • 性别
  • IMClient
  • 兴趣
  • locales
  • 地理位置
  • memberships
  • 元数据
  • 其他关键字
  • names
  • 昵称
  • 职业
  • organizations
  • phoneNumbers
  • 照片
  • 关系
  • sipAddress
  • skills
  • 网址
  • 用户指定
sources[]

enum (DirectorySourceType)

必需。要返回的目录来源。

mergeSources[]

enum (DirectoryMergeSourceType)

(可选)当通过经过验证的联接键(例如电子邮件地址或电话号码)连接时,要合并到目录来源的其他数据。

pageSize

integer

(可选)回复中包含的人数。有效值介于 1 到 1000 之间(含 1 和 1000)。如果未设置或设置为 0,则默认为 100。

pageToken

string

(可选)从上一个响应 nextPageToken 接收的页面令牌。利用其进行后续页面检索。

进行分页时,提供给 people.listDirectoryPeople 的所有其他参数必须与提供页面令牌的第一个调用匹配。

requestSyncToken

boolean

(可选)响应是否应返回 nextSyncToken。通过对请求 syncToken 进行设置,它可用于获取自上次请求以来的增量更改。

如需详细了解同步行为,请访问 people.listDirectoryPeople

syncToken

string

(可选)从之前的响应 nextSyncToken 收到的同步令牌。提供此令牌以仅检索自上次请求后更改的资源。

在同步时,提供给 people.listDirectoryPeople 的所有其他参数必须与提供同步令牌的第一个调用匹配。

如需详细了解同步行为,请访问 people.listDirectoryPeople

请求正文

请求正文必须为空。

响应正文

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

对经过身份验证的用户的网域目录的请求的响应。

JSON 表示法
{
  "people": [
    {
      object (Person)
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string
}
字段
people[]

object (Person)

网域目录中人员列表。

nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段,则不存在后续页面。

nextSyncToken

string

一个令牌,可作为 syncToken 发送以检索自上次请求以来的更改。请求必须设置 requestSyncToken 才能返回同步令牌。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/directory.readonly

如需了解详情,请参阅授权指南