更新联系人的照片。
应依序发送针对同一用户的转变请求,以避免延迟时间增加和失败。
HTTP 请求
PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
resourceName |
必需。人员资源名称 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"photoBytes": string,
"personFields": string,
"sources": [
enum ( |
字段 | |
---|---|
photoBytes |
必需。原始照片字节数 使用 base64 编码的字符串。 |
personFields |
(可选)用于限制返回人员哪些字段的字段掩码。您可以指定多个字段,只需用英文逗号分隔即可。如果未设置,则默认为空,这将跳过后转变转变获取。有效值包括:
|
sources[] |
(可选)要返回的来源类型的掩码。如果未设置,则默认为 |
响应正文
如果成功,响应正文将包含结构如下的数据:
用于更新联系人照片的响应。
JSON 表示法 |
---|
{
"person": {
object ( |
字段 | |
---|---|
person |
更新后的人物(如果在 UpdateContactPhotoRequest 中设置了 personFields);否则将取消设置。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/contacts
如需了解详情,请参阅授权指南。