REST Resource: groups

Recurso: Grupo

Grupos de Google les permite a los usuarios enviar mensajes a grupos de personas con la dirección de correo electrónico del grupo. Para obtener más información sobre las tareas comunes, consulta la Guía para desarrolladores.

Para obtener información sobre otros tipos de grupos, consulta la documentación de la API de Cloud Identity Groups.

Nota: El usuario que llama a la API (o al que una cuenta de servicio suplanta la identidad) debe tener asignado un rol que incluya permisos de grupos de API de administrador, como administrador avanzado o administrador de grupos.

Representación JSON 
{
  "id": string,
  "email": string,
  "name": string,
  "description": string,
  "adminCreated": boolean,
  "directMembersCount": string,
  "kind": string,
  "etag": string,
  "aliases": [
    string
  ],
  "nonEditableAliases": [
    string
  ]
}
Campos
id

string

Solo lectura. Es el ID único de un grupo. Se puede usar un id de grupo como groupKey de un URI de solicitud de grupo.
email

string

Es la dirección de correo electrónico del grupo. Si tu cuenta tiene varios dominios, selecciona el dominio correspondiente para la dirección de correo electrónico. El email debe ser único. Esta propiedad es obligatoria cuando se crea un grupo. Las direcciones de correo electrónico de los grupos están sujetas a las mismas reglas de uso de caracteres que los nombres de usuario. Consulta el Centro de ayuda para obtener más información.
name

string

El nombre visible del grupo.
description

string

Es una descripción extendida que ayuda a los usuarios a determinar el propósito de un grupo. Por ejemplo, puedes incluir información sobre quién debe unirse al grupo, los tipos de mensajes que se deben enviar al grupo, vínculos a preguntas frecuentes sobre el grupo o grupos relacionados. La longitud máxima es de 4,096 caracteres.
adminCreated

boolean

Solo lectura. El valor es true si un administrador, en lugar de un usuario, creó este grupo.
directMembersCount

string (int64 format)

Es la cantidad de usuarios que son miembros directos del grupo. Si un grupo es miembro (secundario) de este grupo (el superior), los miembros del grupo secundario no se cuentan en la propiedad directMembersCount del grupo superior.
kind

string

Tipo de recurso de la API. Para los recursos de Grupos, el valor es admin#directory#group.
etag

string

ETag del recurso.
aliases[]

string

Solo lectura. La lista de las direcciones de correo electrónico de alias de un grupo Para agregar, actualizar o quitar los alias de un grupo, usa los métodos groups.aliases. Si se edita en la solicitud POST o PUT de un grupo, se ignora la edición.
nonEditableAliases[]

string

Solo lectura. Es la lista de las direcciones de correo electrónico de alias no editables del grupo que están fuera del dominio principal o los subdominios de la cuenta. Estas son direcciones de correo electrónico funcionales que usa el grupo. Esta es una propiedad de solo lectura que se muestra en la respuesta de la API para un grupo. Si se edita en la solicitud POST o PUT de un grupo, se ignora la edición.

Métodos

delete

 Borra un grupo.

get

 Recupera las propiedades de un grupo.

insert

 Crea un grupo.

list

 Recupera todos los grupos de un dominio o de un usuario a partir de una userKey (paginada).

patch

 Actualiza las propiedades de un grupo.

update

 Actualiza las propiedades de un grupo.