REST Resource: members

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Recurso: miembro

Un miembro de Grupos de Google puede ser un usuario o algún 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 los grupos, consulta la Guía para programadores.

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 u otro 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

La función 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 la función de un miembro, consulta Asigna funciones de grupo a los miembros.

Los valores aceptables son:

  • MANAGER: Esta función solo está disponible si se habilita Grupos de Google para empresas mediante la Consola del administrador. Consulta Activar o desactivar Grupos para empresas. Una función MANAGER puede hacer todo lo que hace una función de OWNER, excepto convertir a un miembro en un OWNER o borrar el grupo. Un grupo puede tener varios miembros MANAGER.
  • MEMBER: Esta función puede suscribirse a un grupo, ver archivos de debate y ver la lista de miembros del grupo. Para obtener más información sobre las funciones de los miembros, consulta Asigna funciones de grupo a los miembros.
  • OWNER: Esta función permite enviar mensajes al grupo, agregar o quitar miembros, cambiar funciones y cambiar la configuración del grupo, así como borrar el grupo. Un OWNER debe ser miembro del grupo. Un grupo puede tener más de un OWNER.
etag

string

ETag del recurso.

type

string

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 de cliente.
  • EXTERNAL: El miembro es un usuario o grupo que no pertenece al dominio. (No se utiliza 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 del miembro. Solo es compatible con create/update/get.

Los valores aceptables son:

  • ALL_MAIL: Todos los mensajes, enviados en cuanto llegan.
  • DAILY: No más de un mensaje por día.
  • DIGEST: hasta 25 mensajes agrupados en un solo mensaje.
  • DISABLED: Quita la suscripción.
  • NONE: No hay mensajes.
id

string

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

Métodos

delete

Quita a un miembro de un grupo.

get

Recupera las propiedades de un miembro del grupo.

hasMember

Comprueba 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.