Обновите пакет контактов и верните карту имен ресурсов в PersonResponses для обновленных контактов.
Запросы на изменение для одного и того же пользователя следует отправлять последовательно, чтобы избежать увеличения задержек и сбоев.
HTTP-запрос
POST https://people.googleapis.com/v1/people:batchUpdateContacts
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "contacts": { string: { object ( |
Поля | |
---|---|
contacts | Необходимый. Сопоставление названий ресурсов с данными о людях, которые необходимо обновить. Позволяет до 200 контактов в одном запросе. Объект, содержащий список пар |
updateMask | Необходимый. Маска поля, позволяющая ограничить обновляемые поля пользователя. Можно указать несколько полей, разделив их запятыми. Все указанные поля будут заменены или очищены, если они оставлены пустыми для каждого человека. Допустимые значения:
|
readMask | Необходимый. Маска поля, позволяющая ограничить возвращаемые поля для каждого человека. Можно указать несколько полей, разделив их запятыми. Если маска чтения оставлена пустой, post-mutate-get пропускается и в ответе не будут возвращены никакие данные. Допустимые значения:
|
sources[] | Необязательный. Маска того, какие типы источников возвращаются. По умолчанию — |
Тело ответа
В случае неудачи возвращает BatchUpdateContactsErrorDetails
— список ошибок, соответствующих каждому контакту.
Ответ на запрос на обновление пакета контактов.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"updateResult": {
string: {
object ( |
Поля | |
---|---|
updateResult | Сопоставление имен ресурсов с обновленными контактами, если только запрос Объект, содержащий список пар |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/contacts
Дополнительную информацию см. в руководстве по авторизации .