创建一个新的联系人并返回该联系人的人员资源。
如果在联系人来源的单例字段中指定了多个字段,则请求会返回 400 错误:
- 传记
- 生日
- 性别
- names
应依序发送针对同一用户的转变请求,以避免延迟时间增加和失败。
HTTP 请求
POST https://people.googleapis.com/v1/people:createContact
网址采用 gRPC 转码语法。
查询参数
参数 | |
---|---|
personFields |
必需。一个字段掩码,用于限制返回每个人的字段。您可以指定多个字段,只需用英文逗号分隔即可。如果未设置,则默认为所有字段。有效值包括:
|
sources[] |
(可选)要返回的来源类型的掩码。如果未设置,则默认为 |
请求正文
请求正文包含一个 Person
实例。
响应正文
如果成功,响应正文将包含一个 Person
实例。
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/contacts
如需了解详情,请参阅授权指南。