Descripción general de la API de Groups Settings

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