Method: people.createContact

Создайте новый контакт и верните ресурс человека для этого контакта.

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

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

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

HTTP-запрос

POST https://people.googleapis.com/v1/people:createContact

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

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

Параметры
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

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