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

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