La API de configuración de grupos actualiza y recupera la configuración de un Grupo de Google existente. Mediante la API, puedes hacer lo siguiente:
- Modifica la configuración de un grupo para el acceso interno y externo a grupos.
- Editar las notificaciones del grupo.
- Configura el archivado de debates y la moderación de mensajes.
- Personaliza los grupos de usuarios de tu cuenta.
Para conocer más formas de 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 funciona 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 con 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 métodos de configuración de grupos en la API de Groups Settings, como se describe en la siguiente tabla:
| Operación | Descripción | Asignaciones HTTP de REST |
|---|---|---|
get |
Obtiene la configuración de un grupo para la cuenta de un cliente. Un usuario autenticado debe autorizar todas las operaciones get. | 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 Groups Settings muestra datos en formato JSON. La notación Atom es un formato alternativo de datos. Los formatos de datos JSON y Atom admiten capacidades completas de lectura y escritura.
JSON es un formato común de Internet 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 familiares para los programadores de la familia C, como C, C++, C#, Java, JavaScript, Perl y Python.
Para cambiar el formato de datos de la API, incluye 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