Method: people.getBatchGet

通过指定请求的资源名称列表,提供有关特定人员列表的信息。使用 people/me 指示经过身份验证的用户。

如果未指定“personFields”,请求会返回 400 错误。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
resourceNames[]

string

必需。提供相关信息的人员的资源名称。可重复执行。网址查询参数应为

resourceNames=<name1>&resourceNames=<name2>&...

  • 如需获取有关经过身份验证的用户的信息,请指定 people/me
  • 要获取关于 Google 帐号的信息,请指定 people/{account_id}
  • 如需获取联系人的相关信息,请指定 people.connections.list 返回的用于标识联系人的资源名称。

最多 200 个资源名称。

requestMask
(deprecated)

object (RequestMask)

已弃用(请改用 personFields

用于将结果限制为部分人员字段的掩码。

personFields

string (FieldMask format)

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

  • addresses
  • ageRanges
  • 传记
  • 生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • events
  • externalIds
  • 性别
  • imClients
  • 兴趣
  • locales
  • 位置
  • memberships
  • 元数据
  • miscKeywords
  • names
  • 昵称
  • 职业
  • organizations
  • phoneNumbers
  • 照片
  • 关系
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

可选。要返回哪些来源类型的掩码。如果未设置,则默认为 READ_SOURCE_TYPE_CONTACTREAD_SOURCE_TYPE_PROFILE

请求正文

请求正文必须为空。

响应正文

get 请求(按资源名称列出人员)的响应。

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

JSON 表示法
{
  "responses": [
    {
      object (PersonResponse)
    }
  ]
}
字段
responses[]

object (PersonResponse)

每个所请求资源名称的响应。

授权范围

无需授权即可访问公开数据。对于私密数据,必须提供以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/contacts.other.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile
  • https://www.googleapis.com/auth/profile.language.read

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