A API Groups Settings é atualizada e recupera configurações de um grupo do Google. Com a API, é possível fazer o seguinte:
- Modificar as configurações de um grupo para o acesso interno e externo do grupo
- Editar as notificações do grupo.
- Configurar o arquivamento de discussões e a moderação de mensagens.
- Personalize os grupos de usuários da sua conta.
Para ver novas formas de trabalhar com o Grupos do Google ou gerenciar outros tipos de grupos, consulte a documentação do Cloud Identity.
Modelo de dados da API Groups Settings
A API Groups Settings funciona em um recurso Groups que representa como os usuários de uma conta se comunicam e colaboram com grupos de outras pessoas. Cada grupo é identificado pelo endereço de e-mail dele.
O modelo de dados da API é baseado na coleção Groups dos grupos da conta. Cada grupo tem um conjunto exclusivo de configurações.
Operações da API Groups Settings
É possível chamar métodos de configurações de grupo na API Groups Settings, conforme descrito na tabela a seguir:
| Operação | Descrição | Mapeamentos HTTP REST |
|---|---|---|
get |
Recebe as configurações do grupo para a conta do cliente. Todas as operações "get" precisam ser autorizadas por um usuário autenticado. | GET em um URI de grupo. |
update |
Atualiza as configurações do grupo para a conta do cliente. Todas as operações de atualização precisam ser autorizadas por um usuário autenticado. | PUT em um URI de grupo. |
Formatos de dados JSON e Atom
Por padrão, a API Groups Settings retorna dados no formato JSON. A notação Atom é um formato de dados alternativo. Os formatos de dados JSON e Atom são compatíveis com recursos completos de leitura e gravação.
O JSON é um formato comum da Internet que fornece um método para representar estruturas de dados arbitrárias. De acordo com json.org, JSON é um formato de texto completamente independente de linguagem, mas usa convenções conhecidas por programadores da família C de linguagens, incluindo C, C++, C#, Java, JavaScript, Perl e Python.
Para alterar o formato de dados da API, inclua a string de consulta alt no URI da solicitação, por exemplo:
JSON
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json
Atom
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom