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