Method: people.createContact

创建一个新的联系人并返回该联系人的人员资源。

如果在联系人来源的单例字段中指定了多个字段,则请求会返回 400 错误:

  • 传记
  • 生日
  • 性别
  • names

应依序发送针对同一用户的转变请求,以避免延迟时间增加和失败。

HTTP 请求

POST https://people.googleapis.com/v1/people:createContact

网址采用 gRPC 转码语法。

查询参数

参数
personFields

string (FieldMask format)

必需。一个字段掩码,用于限制返回每个人的字段。您可以指定多个字段,只需用英文逗号分隔即可。如果未设置,则默认为所有字段。有效值包括:

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

enum (ReadSourceType)

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

请求正文

请求正文包含一个 Person 实例。

响应正文

如果成功,响应正文将包含一个 Person 实例。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/contacts

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