Method: people.listDirectoryPeople

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

指定 syncToken 后,自上次同步后删除的资源将以人的身份返回,并将 PersonMetadata.deleted 设置为 true。

指定 pageTokensyncToken 时,所有其他请求参数必须与第一次调用匹配。

对于同步请求,写入操作的传播延迟可能会持续几分钟。增量同步不适用于写后读用例。

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

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
readMask

string (FieldMask format)

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

  • addresses
  • ageRanges
  • 传记
  • 生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • events
  • externalIds
  • 性别
  • imClients
  • 兴趣
  • locales
  • 位置
  • memberships
  • 元数据
  • miscKeywords
  • names
  • 昵称
  • 职业
  • organizations
  • phoneNumbers
  • 照片
  • 关系
  • sipAddresses
  • skills
  • urls
  • userDefined
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

有关详情,请参阅授权指南