La API de Configuración de grupos actualiza y recupera la configuración de un Grupo de Google existente. A través de la API, puedes hacer lo siguiente:
- Modifica la configuración de un grupo para el acceso de grupos internos y externos.
- Edita las notificaciones del grupo.
- Configura el archivo de debates y la moderación de mensajes.
- Personalizar 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 configuración de grupos
La API de Configuración de grupos 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 con la dirección de correo electrónico del grupo.
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 opciones de configuración.
Operaciones de la API de configuración de grupos
Puedes llamar a métodos de configuración de grupo en la API de Configuración de grupos, como se describe en la siguiente tabla:
| Operación | Descripción | Asignaciones HTTP de REST |
|---|---|---|
get |
Obtiene la configuración de un grupo de la cuenta de un cliente. Todas las operaciones get 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 Atom y JSON
De forma predeterminada, la API de Grupos Settings muestra datos en formato JSON. La notación Atom es un formato de datos alternativo. Los formatos de datos JSON y Atom admiten todas las funciones 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 que es completamente independiente del lenguaje, pero usa convenciones que son familiares para los programadores de la familia C de lenguajes, incluidos C, C++, C#, Java, JavaScript, Perl y Python.
Para cambiar el formato de datos de la API, incluye la cadena de consulta alt en la 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