Обзор API настроек групп

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