Method: people.updateContact

Обновите контактные данные существующего контактного лица. Любые бесконтактные данные не будут изменены. Любые неконтактные данные человека, которого необходимо обновить, будут игнорироваться. Все поля, указанные в updateMask , будут заменены.

Сервер возвращает ошибку 400, если для обновляемого контакта не указан person.metadata.sources или если источник контакта отсутствует.

Сервер возвращает ошибку 400 с причиной "failedPrecondition" если person.metadata.sources.etag отличается от etag контакта, что указывает на то, что контакт изменился с момента чтения его данных. Клиенты должны получить самую последнюю информацию о человеке и объединить свои обновления с последней информацией о человеке. При последовательном обновлении одному и тому же человеку следует использовать etag из ответа updateContact , чтобы избежать сбоев.

Сервер возвращает ошибку 400, если memberships обновляется и для человека не указано членство в группах контактов.

Сервер возвращает ошибку 400, если в поле, которое является одноэлементным для источников контактов, указано более одного поля:

  • биографии
  • дни рождения
  • полы
  • имена

Запросы на изменение для одного и того же пользователя следует отправлять последовательно, чтобы избежать увеличения задержек и сбоев.

HTTP-запрос

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
person.resourceName

string

Имя ресурса для человека, назначенное сервером. Строка ASCII в формате people/{person_id} .

Параметры запроса

Параметры
updatePersonFields

string ( FieldMask format)

Необходимый. Маска поля, позволяющая ограничить обновляемые поля пользователя. Можно указать несколько полей, разделив их запятыми. Все обновленные поля будут заменены. Допустимые значения:

  • адреса
  • биографии
  • дни рождения
  • календарные URL-адреса
  • данные клиента
  • электронная почтаАдреса
  • события
  • внешние идентификаторы
  • полы
  • imClients
  • интересы
  • локали
  • локации
  • членство
  • РазноеКлючевые слова
  • имена
  • прозвища
  • занятия
  • организации
  • ТелефонНомера
  • отношения
  • sipАдреса
  • URL-адреса
  • определяемый пользователем
personFields

string ( FieldMask format)

Необязательный. Маска поля, позволяющая ограничить возвращаемые поля для каждого человека. Можно указать несколько полей, разделив их запятыми. По умолчанию для всех полей, если не установлено. Допустимые значения:

  • адреса
  • ВозрастДиапазоны
  • биографии
  • дни рождения
  • календарные URL-адреса
  • данные клиента
  • обложкаФотографии
  • электронная почтаАдреса
  • события
  • внешние идентификаторы
  • полы
  • imClients
  • интересы
  • локали
  • локации
  • членство
  • метаданные
  • РазноеКлючевые слова
  • имена
  • прозвища
  • занятия
  • организации
  • ТелефонНомера
  • фотографии
  • отношения
  • sipАдреса
  • навыки
  • URL-адреса
  • определяемый пользователем
sources[]

enum ( ReadSourceType )

Необязательный. Маска того, какие типы источников возвращаются. По умолчанию — READ_SOURCE_TYPE_CONTACT и READ_SOURCE_TYPE_PROFILE , если не установлено.

Тело запроса

Тело запроса содержит экземпляр Person .

Тело ответа

В случае успеха тело ответа содержит экземпляр Person .

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/contacts

Дополнительную информацию см. в руководстве по авторизации .