API настроек групп обновляет и извлекает настройки для существующей группы Google . Через API вы можете сделать следующее:
- Измените настройки группы для доступа к внутренней и внешней группе.
- Редактировать уведомления группы.
- Настройте архивирование обсуждений и модерацию сообщений.
- Настройте группы пользователей вашей учетной записи.
Дополнительные способы работы с группами Google или управления другими типами групп см. в документации Cloud Identity .
Модель данных API настроек групп
API настроек групп работает с ресурсом Groups , который показывает, как пользователи в учетной записи общаются и сотрудничают с группами других людей. Каждая группа идентифицируется по адресу электронной почты группы.
Модель данных API основана на коллекции Groups групп учетной записи. Каждая группа имеет уникальный набор настроек конфигурации.
Операции API настроек групп
Вы можете вызвать методы настроек группы в API настроек групп, как описано в следующей таблице:
| Операция | Описание | Сопоставления REST HTTP |
|---|---|---|
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