A API Groups Settings atualiza e recupera as configurações de um Grupo do Google. Por meio da API, você pode fazer o seguinte:
- modificar as configurações de acesso de grupos internos e externos em um grupo;
- Edite 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 outras formas de trabalhar com os 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 opera em um recurso Groups que representa como os usuários
em uma conta se comunicam e colaboram com grupos de outras pessoas. Cada grupo é identificado
pelo endereço de e-mail do grupo.
O modelo de dados da API tem como base a coleção Groups dos grupos da conta. Cada
grupo tem um conjunto exclusivo de configurações.
Operações da API Groups Settings
Você pode chamar métodos de configurações do grupo na API Groups Settings, conforme descrito na tabela a seguir:
| Operação | Descrição | Mapeamentos HTTP REST |
|---|---|---|
get |
Acessa as configurações de um grupo para a conta de um cliente. Todas as operações "get" precisam ser autorizadas por um usuário autenticado. | GET no URI de um grupo. |
update |
Atualiza as configurações de um grupo para a conta de um cliente. Todas as operações de atualização precisam ser autorizadas por um usuário autenticado. | PUT no URI de um 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.
JSON é um formato comum da Internet que oferece 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 que usa convenções conhecidas dos programadores da família C de linguagens, incluindo C, C++, C#, Java, JavaScript, Perl e Python.
Para mudar 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