REST Resource: members

Recurso: Miembro

Un miembro de Grupos de Google puede ser un usuario o otro grupo. Este miembro puede estar dentro o fuera de los dominios de tu cuenta. Para obtener más información sobre las tareas comunes de los miembros de un grupo, consulta la Guía para desarrolladores.

Representación JSON
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
Campos
kind

string

Tipo de recurso de la API. Para los recursos de miembros, el valor es admin#directory#member.

email

string

La dirección de correo electrónico del miembro. Un miembro puede ser un usuario o un grupo. Esta propiedad es obligatoria cuando se agrega un miembro a un grupo. El email debe ser único y no puede ser un alias de otro grupo. Si se cambia la dirección de correo electrónico, la API refleja automáticamente los cambios.

role

string

El rol del miembro en un grupo. La API muestra un error para los ciclos en las membresías de grupo. Por ejemplo, si group1 es miembro de group2, group2 no puede ser miembro de group1. Para obtener más información sobre el rol de un miembro, consulta Asigna roles de grupo a los miembros.

Los valores aceptables son:

  • MANAGER: Este rol solo está disponible si los Grupos de Google para empresas están habilitados con la Consola del administrador. Consulta Cómo activar o desactivar Grupos para empresas. Un rol MANAGER puede hacer todo lo que hace un rol OWNER, excepto convertir a un miembro en OWNER o borrar el grupo. Un grupo puede tener varios miembros de MANAGER.
  • MEMBER: Con este rol, puedes suscribirte a un grupo, ver los archivos de debate y la lista de membresías del grupo. Para obtener más información sobre los roles de los miembros, consulta Asigna roles de grupo a los miembros.
  • OWNER: Con este rol, se pueden enviar mensajes al grupo, agregar o quitar miembros, cambiar sus roles, cambiar la configuración del grupo y borrarlo. Un OWNER debe ser miembro del grupo. Un grupo puede tener más de un OWNER.
etag

string

ETag del recurso.

type

string

Es el tipo de miembro del grupo.

Los valores aceptables son:

  • CUSTOMER: El miembro representa a todos los usuarios de un dominio. No se muestra una dirección de correo electrónico, y el ID que se muestra es el ID del cliente.
  • EXTERNAL: El miembro es un usuario o grupo ajeno al dominio. (No se usa actualmente)
  • GROUP: El miembro es otro grupo.
  • USER: El miembro es un usuario.
status

string

Estado del miembro (inmutable)

delivery_settings

string

Define las preferencias de entrega de correo electrónico del miembro. Este campo solo es compatible con los métodos insert, update y get.

Los valores aceptables son:

  • ALL_MAIL: Todos los mensajes se entregan en cuanto llegan.
  • DAILY: No más de un mensaje al día.
  • DIGEST: Hasta 25 mensajes agrupados en uno solo.
  • DISABLED: Quita la suscripción.
  • NONE: No hay mensajes.
id

string

El ID único del miembro del grupo. Un id de miembro se puede usar como memberKey del URI de solicitud de miembro.

Métodos

delete

Quita a un miembro de un grupo.

get

Recupera las propiedades de un miembro de un grupo.

hasMember

Verifica si el usuario determinado es miembro del grupo.

insert

Agrega un usuario al grupo especificado.

list

Recupera una lista paginada de todos los miembros de un grupo.

patch

Actualiza las propiedades de membresía de un usuario en el grupo especificado.

update

Actualiza la membresía de un usuario en el grupo especificado.