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