API настроек групп обновляет и извлекает настройки для существующей группы Google . Через API вы можете сделать следующее:
- Измените настройки группы для доступа к внутренней и внешней группе.
- Отредактируйте уведомления группы.
- Настройте архивирование обсуждений и модерацию сообщений.
- Настройте группы пользователей вашей учетной записи.
Дополнительные способы работы с группами Google или управления другими типами групп см. в документации по Cloud Identity .
Модель данных API настроек групп
API настроек групп работает с ресурсом Groups , который представляет, как пользователи в рамках учетной записи общаются и сотрудничают с группами других людей. Каждая группа идентифицируется по адресу электронной почты группы.
Модель данных API основана на коллекции Groups учетной записи. Каждая группа имеет уникальный набор параметров конфигурации.
Операции API настроек групп
Вы можете вызвать методы групповых настроек в API настроек групп, как описано в следующей таблице:
| Операция | Описание | HTTP-сопоставления REST |
|---|---|---|
get | Получает настройки группы для учетной записи клиента. Все операции получения должны быть авторизованы аутентифицированным пользователем. | GET групповой URI. |
update | Обновляет настройки группы для учетной записи клиента. Все операции обновления должны быть авторизованы аутентифицированным пользователем. | PUT на групповой URI. |
Форматы данных JSON и Atom
По умолчанию API настроек групп возвращает данные в формате JSON. Нотация Atom — это альтернативный формат данных. Форматы данных JSON и Atom поддерживают все возможности чтения и записи.
JSON — это распространенный интернет-формат, который предоставляет метод представления произвольных структур данных. Согласно json.org , JSON — это текстовый формат, полностью независимый от языка, но использующий соглашения, знакомые программистам языков семейства C, включая C, C++, C#, Java, JavaScript, Perl и Python.
Чтобы изменить формат данных API, включите строку запроса alt в URI вашего запроса, например:
JSON
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json
Атом
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom