REST Resource: groups

Recurso: Grupo

Grupos de Google permite que los usuarios envíen mensajes a grupos de personas por medio de 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 que es víctima de una suplantación de identidad por una cuenta de servicio) debe tener asignada una función que incluya permisos de grupos de la 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. El ID único de un grupo. Se puede usar un id de grupo como el groupKey del URI de una solicitud grupal.

email

string

La dirección de correo electrónico del grupo. Si tu cuenta tiene varios dominios, selecciona el que corresponda 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 grupo 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 para ayudar a los usuarios a determinar el propósito de un grupo. Por ejemplo, puedes incluir información sobre quién se une al grupo, los tipos de mensajes que quieres 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 creó este grupo en lugar de un usuario.

directMembersCount

string (int64 format)

Indica la cantidad de usuarios que son miembros directos del grupo. Si un grupo es miembro (secundario) de este grupo (el grupo superior), sus miembros no se contarán 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 alias de direcciones de correo electrónico 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. La lista de alias de direcciones de correo electrónico no editables del grupo que están fuera del dominio o los subdominios principales de la cuenta. Son direcciones de correo electrónico en funcionamiento que utiliza 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.