Обновите контактные данные для существующего контактного лица. Любые неконтактные данные не будут изменены. Любые неконтактные данные лица, которое нужно обновить, будут игнорироваться. Все поля, указанные в updateMask
, будут заменены.
Сервер возвращает ошибку 400, если для обновляемого контакта не указан person.metadata.sources
или если отсутствует источник контакта.
Сервер возвращает ошибку 400 с причиной "failedPrecondition"
, если person.metadata.sources.etag
отличается от etag контакта, что указывает на то, что контакт изменился после того, как его данные были прочитаны. Клиенты должны получить самого последнего человека и объединить свои обновления с последним человеком.
Сервер возвращает ошибку 400, если memberships
обновляется и для человека не указано членство в контактной группе.
Сервер возвращает ошибку 400, если в поле, которое является одноэлементным для источников контактов, указано более одного поля:
- биографии
- дни рождения
- пол
- имена
Запросы на изменение для одного и того же пользователя следует отправлять последовательно, чтобы избежать увеличения задержки и сбоев.
HTTP-запрос
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
person.resourceName | Имя ресурса для человека, назначенное сервером. Строка ASCII в формате |
Параметры запроса
Параметры | |
---|---|
updatePersonFields | Необходимый. Маска поля для ограничения того, какие поля на человеке обновляются. Можно указать несколько полей, разделив их запятыми. Все обновленные поля будут заменены. Допустимые значения:
|
personFields | По желанию. Маска поля для ограничения возвращаемых полей для каждого человека. Можно указать несколько полей, разделив их запятыми. По умолчанию для всех полей, если не установлено. Допустимые значения:
|
sources[] | По желанию. Маска исходных типов для возврата. По умолчанию это |
Тело запроса
Тело запроса содержит экземпляр Person
.
Тело ответа
В случае успеха тело ответа содержит экземпляр Person
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/contacts
Дополнительные сведения см. в руководстве по авторизации .