Descripción general de la API de Groups Settings

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:

  • Modifica la configuración de un grupo para el acceso interno y externo.
  • Edita 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 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 dentro 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 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 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 Groups Settings muestra datos en formato JSON. La notación Atom es un formato de datos alternativo. Los formatos de datos JSON y Atom admiten capacidades de lectura y escritura completas.

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 que depende por completo del lenguaje, pero que usa convenciones conocidas por los programadores de la familia C, 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 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