Method: people.batchCreateContacts

Создайте пакет новых контактов и верните PersonResponses для нового

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

HTTP-запрос

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

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

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление JSON
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Поля
contacts[]

object ( ContactToCreate )

Необходимый. Контакт для создания. Позволяет до 200 контактов в одном запросе.

readMask

string ( FieldMask format)

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

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

enum ( ReadSourceType )

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

Тело ответа

В случае успеха тело ответа содержит данные со следующей структурой:

В случае неудачи возвращает BatchCreateContactsErrorDetails , который содержит список ошибок для каждого недопустимого контакта.

Ответ на запрос на создание пакета контактов.

Представление JSON
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Поля
createdPeople[]

object ( PersonResponse )

Контакты, которые были созданы, если запрос readMask не пуст.

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

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

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

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

КонтактыToCreate

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

Представление JSON
{
  "contactPerson": {
    object (Person)
  }
}
Поля
contactPerson

object ( Person )

Необходимый. Данные человека для заполнения вновь созданного источника.