Method: contactGroups.create

Создайте новую группу контактов, принадлежащую авторизованному пользователю.

Имена создаваемых групп контактов должны быть уникальными для групп контактов пользователей. Попытка создать группу с повторяющимся именем приведет к ошибке HTTP 409.

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

HTTP-запрос

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

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

Тело запроса

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

JSON-представление 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Поля
contactGroup

object ( ContactGroup )

Необходимый. Контактную группу, которую необходимо создать.

readGroupFields

string ( FieldMask format)

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

  • данные клиента
  • Тип группы
  • метаданные
  • имя

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр ContactGroup .

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

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

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

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