La API de Groups Settings actualiza y recupera la configuración de un Grupo de Google existente. A través de la API, puedes hacer lo siguiente:
- Modificar la configuración de un grupo para el acceso interno y externo
- Editar las notificaciones del grupo
- Configurar el archivado de debates y la moderación de mensajes
- Personaliza los grupos de usuarios de tu cuenta.
Para obtener más información sobre cómo trabajar con Grupos de Google o administrar otros tipos de grupos, consulta la documentación de Cloud Identity.
Modelo de datos de la API de Groups Settings
La API de Groups Settings opera en un recurso Groups que representa cómo los usuarios de una cuenta se comunican y colaboran con grupos de otras personas.
Cada grupo se identifica por su dirección de correo electrónico.
El modelo de datos de la API se basa en la colección Groups de los grupos de la cuenta.
Cada grupo tiene un conjunto único de parámetros de configuración.
Operaciones de la API de Groups Settings
Puedes llamar a los métodos de configuración de grupos en la API de Group Settings, como se describe en la siguiente tabla:
| Operación | Descripción | Asignaciones de HTTP de REST |
|---|---|---|
get |
Obtiene la configuración de un grupo para la cuenta de un cliente. Todas las operaciones de obtención deben estar autorizadas por un usuario autenticado. | GET en un URI de grupo. |
update |
Actualiza la configuración de un grupo para la cuenta de un cliente. Todas las operaciones de actualización deben estar autorizadas por un usuario autenticado. | PUT en un URI de grupo. |
Formatos de datos JSON y Atom
De forma predeterminada, la API de Group Settings devuelve datos en formato JSON. La notación Atom es un formato de datos alternativo. Los formatos de datos JSON y Atom admiten capacidades completas de lectura y escritura.
JSON es un formato de Internet común que proporciona un método para representar estructuras de datos arbitrarias. Según json.org, JSON es un formato de texto completamente independiente del lenguaje, pero usa convenciones que son familiares para los programadores de la familia de lenguajes C, incluidos C, C++, C#, Java, JavaScript, Perl y Python.
Puedes cambiar el formato de datos de la API si incluyes la cadena de consulta alt en el URI de tu solicitud. Por ejemplo:
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