Method: contactGroups.members.modify

Измените членов группы контактов, принадлежащей аутентифицированному пользователю.

Единственные системные группы контактов, в которые можно добавлять участников, — это contactGroups/myContacts и contactGroups/starred . Другие группы контактов системы устарели, и их можно только удалить.

HTTP-запрос

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

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

Параметры пути

Параметры
resourceName

string

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

Тело запроса

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

JSON-представление
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
Поля
resourceNamesToAdd[]

string

Необязательный. Имена ресурсов контактных лиц, которых нужно добавить, в форме people/{person_id} . Общее количество имен ресурсов в resourceNamesToAdd и resourceNamesToRemove должно быть меньше или равно 1000.

resourceNamesToRemove[]

string

Необязательный. Имена ресурсов контактных лиц, которых нужно удалить, в формеpeople people/{person_id} . Общее количество имен ресурсов в resourceNamesToAdd и resourceNamesToRemove должно быть меньше или равно 1000.

Тело ответа

Ответ на запрос на изменение участников группы контактов.

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

JSON-представление
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
Поля
notFoundResourceNames[]

string

Имена ресурсов контактных лиц, которые не были найдены.

canNotRemoveLastContactGroupResourceNames[]

string

Имена ресурсов контактных лиц, которые нельзя удалить из последней группы контактов.

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

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

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

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