Comentarios Editar

tipo de recurso de grupo

  • Artigo
  • 21 minutos de lectura

Espacio de nombres: microsoft.graph

Representa un grupo de Azure Active Directory (Azure AD) que puede ser un grupo de Microsoft 365 o un grupo de seguridad. Este recurso es de tipo abierto y permite que pasen otras propiedades.

Se hereda de directoryObject.

Por motivos de rendimiento, las operaciones create, get y list devuelven solo un subconjunto de las propiedades más usadas de forma predeterminada. Estas propiedades predeterminadas se indican en la sección Propiedades. Para obtener propiedades que no se devuelven de forma predeterminada, especifíquelas en una opción de consulta de OData $select.

Este recurso admite:

  • que agregue sus propios datos a las propiedades personalizadas como extensiones.
  • que se suscriba a notificaciones de cambios.
  • El uso de una consulta delta para realizar un seguimiento de adiciones, eliminaciones y actualizaciones incrementales al proporcionar una función delta.

Métodos

Método Tipo de valor devuelto Descripción
Administración de grupos
Crear grupo grupo Crea un grupo nuevo. Puede ser un grupo, un grupo dinámico o un grupo de seguridad de Microsoft 365.
Obtener grupo grupo Lee las propiedades de un objeto de grupo.
Enumerar grupos Colección group Enumera los objetos de grupo y sus propiedades.
Grupo de actualización Ninguno Actualiza las propiedades de un objeto de grupo.
Eliminar grupo Ninguno Elimina el objeto de grupo.
delta Colección group Obtiene los cambios incrementales de grupos.
Agregar miembros Ninguno Agregue un usuario o grupo a este grupo publicando en la propiedad de navegación de miembros (compatible solo con grupos de seguridad y grupos de Microsoft 365).
Agregar propietarios Ninguno Agregue un nuevo propietario para el grupo publicando en la propiedad de navegación de propietarios (compatible solo con grupos de seguridad y grupos de Microsoft 365).
Create setting groupSetting Crea un objeto de configuración según una plantilla de groupSettingTemplate. La solicitud POST debe proporcionar settingValues para toda la configuración establecida en la plantilla. Solo se pueden usar plantillas específicas de grupos para esta operación.
Delete setting Ninguno Elimina un objeto de configuración.
Get setting groupSetting Lee las propiedades de un objeto de configuración específico.
Mostrar groupLifecyclePolicies Colección de groupLifecyclePolicy Muestra las directivas de ciclo de vida del grupo.
Enumerar los miembros Colección directoryObject Obtiene los miembros directos de este grupo de la propiedad de navegación members.
Enumerar propietarios Colección directoryObject Obtiene los propietarios del grupo desde la propiedad de navegación owners.
Configuración de la lista Colección de groupSetting Enumera las propiedades de todos los objetos de configuración.
Enumerar miembros transitivos Colección directoryObject Obtiene los usuarios, grupos y dispositivos que son miembros, incluidos los miembros anidados de este grupo.
Enumerar miembros de transitivos Colección directoryObject Lista de grupos a los que pertenece este grupo. Esta operación es transitiva e incluye los grupos de los que este grupo es un miembro anidado.
Eliminar miembro Ninguno Quite un miembro de un grupo de Microsoft 365 o un grupo de seguridad a través de la propiedad de navegación members.
Eliminar propietario Ninguno Quite un propietario de un grupo de Microsoft 365 o un grupo de seguridad a través de la propiedad de navegación de owners.
Update setting groupSetting Actualiza el objeto de configuración.
assignLicense group Agrega o quita suscripciones del grupo. También puede habilitar y deshabilitar los planes específicos asociados a una suscripción.
renovar Booleano Renueva la expiración de un grupo. Cuando se renueva un grupo, la expiración del grupo se amplía por el número de días definidos en la directiva.
validateProperties JSON Valide que el nombre para mostrar de un grupo de Microsoft 365 o el alias de correo cumpla con las directivas de nomenclatura.
Asignaciones de roles de aplicación
Enumerar appRoleAssignments Colección appRoleAssignment Obtiene las aplicaciones y roles de aplicación que se han asignado al grupo.
Agregar appRoleAssignment appRoleAssignment Asigna un rol de aplicación a este grupo.
Eliminar appRoleAssignment Ninguno. Elimina una asignación de roles de aplicación de este grupo.
Calendario
Crear evento evento Crea un evento al publicarlo en la colección de eventos.
Obtener evento evento Lee las propiedades de un objeto de evento.
Lista de eventos Colección event Obtiene una colección de objetos de evento.
Actualizar evento Ninguno Actualiza las propiedades del objeto de evento.
Eliminar evento Ninguno Elimina el objeto de evento.
Lista de calendarView Colección de eventos Obtiene una colección de eventos en un intervalo de tiempo especificado.
Conversaciones
Crear conversación conversation Crea una conversación al publicarla en la colección de conversaciones.
Obtener conversación conversación Lee las propiedades de un objeto de conversación.
Lista de conversaciones Colección de conversaciones Obtiene una colección de objetos de conversación.
Eliminar conversación Ninguno Elimina un objeto de conversación.
Crear hilo Hilo de conversación Crear un nuevo hilo de conversación
Obtener conversación conversationThread Lee las propiedades de un objeto de conversación.
Lista de conversaciones Colección conversationThread Obtiene todas las conversaciones de un grupo.
Actualizar conversación Ninguno Actualiza las propiedades de un objeto de conversación.
Eliminar conversación Ninguno Elimina un objeto de conversación.
Lista de acceptedSenders Colección directoryObject Obtiene una lista de usuarios o grupos que se encuentran en la lista de remitentes aceptados de este grupo.
Agregar acceptedSenders directoryObject Agrega un usuario o grupo a la colección acceptSenders.
Eliminar acceptedSender directoryObject Elimina a un usuario o grupo de la colección acceptedSenders.
Enumerar rejectedSenders Colección directoryObject Obtiene una lista de usuarios o grupos que se encuentran en la lista de remitentes rechazados de este grupo.
Agregar rejectedSender directoryObject Agrega un nuevo usuario o grupo a la colección rejectedSenders.
Eliminar rejectedSender directoryObject Elimina un nuevo usuario o grupo de la colección rejectedSenders.
Create setting groupSetting Crea un objeto de configuración según una plantilla de groupSettingTemplate. La solicitud POST debe proporcionar settingValues para toda la configuración establecida en la plantilla. Solo se pueden usar plantillas específicas de grupos para esta operación.
Objetos de directorio
Enumerar grupos eliminados Colección directoryObject Recupere los grupos eliminados en el espacio empresarial en los últimos 30 días.
Enumerar grupos eliminados propiedad del usuario Colección directoryObject Recupere los grupos eliminados en el espacio empresarial en los últimos 30 días y que son propiedad de un usuario.
Obtener grupo eliminado Colección directoryObject Recuperar un grupo eliminado por identificador.
Restaurar grupo eliminado Colección directoryObject Restaurar un grupo eliminado en el espacio empresarial en los últimos 30 días.
Eliminar grupo permanentemente Colección directoryObject Elimine permanentemente un grupo eliminado del espacio empresarial.
checkMemberGroups Colección string Comprueba la pertenencia de este grupo a una lista de grupos. La función es transitiva.
getMemberGroups Colección string Devuelve todos los grupos de los que el grupo es miembro. La función es transitiva.
checkMemberObjects Colección de cadenas Comprobar la pertenencia en una lista de objetos de grupo, rol de directorio o unidad administrativa. La función es transitiva.
getMemberObjects Colección string Devuelve todos los grupos y unidades administrativas de los que el usuario es miembro. La función es transitiva.
Configuración de grupo
Get setting groupSetting Lee las propiedades de un objeto de configuración específico.
Configuración de la lista Colección de groupSetting Enumera las propiedades de todos los objetos de configuración.
Configuración de actualización Ninguno Actualiza el objeto de configuración.
Delete setting Ninguno Elimina un objeto de configuración.
Obtener plantilla de configuración Ninguno Lea las propiedades de una plantilla de configuración.
Enumerar plantilla de configuración Ninguno Enumera las propiedades de todas las plantillas de configuración.
Extensiones abiertas
Crear extensión abierta openTypeExtension Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o un recurso existente.
Obtener extensión abierta Colección openTypeExtension Obtiene una extensión abierta identificada por el nombre de extensión.
Extensiones de esquema
Agregar valores de extensión de esquema Ninguno Crea una definición de extensión de esquema y, después, la usa para agregar datos escritos personalizados a un recurso.
Otros recursos de grupo
Enumerar fotos Colección profilePhoto Obtiene una colección de fotos de perfil para el grupo.
Enumerar plannerPlans Colección plannerPlan Obtiene planes de Planner que pertenecen al grupo.
Configuración de usuario
addFavorite Ninguno Agrega el grupo a la lista de grupos favoritos del usuario con la sesión iniciada. Compatible solo con grupos de Microsoft 365.
removeFavorite Ninguno Elimina el grupo de la lista de grupos favoritos del usuario con la sesión iniciada. Compatible solo con grupos de Microsoft 365.
Enumerar memberOf Colección directoryObject Obtiene los grupos y las unidades administrativas de los que el usuario es miembro directo desde la propiedad de navegación memberOf.
subscribeByMail Ninguno Establecer la propiedad isSubscribedByMail en true. Permite que el usuario que ha iniciado sesión pueda recibir conversaciones de correo electrónico. Solo se admite para grupos de Microsoft 365.
unsubscribeByMail Ninguno Establecer la propiedad isSubscribedByMail en false. Impide que el usuario que ha iniciado sesión pueda recibir conversaciones de correo electrónico. Solo se admite para grupos de Microsoft 365.
resetUnseenCount Ninguno Restablece a 0 la unseenCount de todas las publicaciones que el usuario que ha iniciado sesión no ha visto desde su última visita. Compatible solo con grupos de Microsoft 365.

Propiedades

Importante

El uso específico de $filter y el parámetro de consulta $search solo se admite cuando se usa el encabezado ConsistencyLevel establecido en eventual y $count. Para obtener más información, vea funciones de consulta avanzadas en Azure AD objetos de directorio.

Propiedad Tipo Descripción
allowExternalSenders Boolean Indica si las personas externas a la organización pueden enviar mensajes al grupo. El valor predeterminado es false.

Solo se devuelve en $select. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
assignedLabels Colección assignedLabel La lista de los pares de etiquetas de confidencialidad (Id. de etiqueta, nombre de etiqueta) asociados a un grupo de Microsoft 365.

Solo se devuelve en $select. Solo lectura.
assignedLicenses Colección assignedLicense Licencias asignadas al grupo.

Solo se devuelve en $select. Admite $filter (eq). Solo lectura.
autoSubscribeNewMembers Boolean Indica si los nuevos miembros agregados al grupo se suscribirán automáticamente para recibir notificaciones por correo electrónico. Puede establecer esta propiedad en una solicitud PATCH para el grupo; no lo establezca en la solicitud POST inicial que crea el grupo. El valor predeterminado es false.

Solo se devuelve en $select. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
classification String Describe una clasificación para el grupo (como impacto en el negocio bajo, medio o alto). Los valores válidos para esta propiedad se definen mediante la creación de un valor setting ClassificationList, basado en la definición de plantilla.

Devuelto de forma predeterminada. Admite $filter (eq, ne, not, ge, le, startsWith).
createdDateTime DateTimeOffset Marca de tiempo de cuando se creó el grupo. El valor no puede modificarse y se rellena automáticamente al crear el grupo. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in). Solo lectura.
deletedDateTime DateTimeOffset Para algunos objetos de Active Directory Azure (usuario, grupo, aplicación), si se elimina el objeto, primero se elimina lógicamente, y esta propiedad se actualiza con la fecha y hora en que se eliminó el objeto. De lo contrario, esta propiedad es null. Si se restaura el objeto, esta propiedad se actualiza a null.
description String Una descripción opcional del grupo.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, startsWith) y $search.
displayName Cadena El nombre para mostrar del grupo. Esta propiedad es necesaria cuando se crea un grupo y no se puede borrar durante las actualizaciones. La longitud máxima es de 256 caracteres.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null), $search y $orderBy.
expirationDateTime DateTimeOffset Marca de tiempo de la fecha de expiración del grupo. El valor no puede modificarse y se rellena automáticamente al crear el grupo. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in). Solo lectura.
groupTypes Colección de cadena Especifica el tipo de grupo y su pertenencia.

Si la colección contiene Unified, el grupo es un grupo de Microsoft 365; de lo contrario, es un grupo de seguridad o un grupo de distribución. Para más información, consulte información general de grupos.

Si la colección incluye DynamicMembership, el grupo tiene pertenencia dinámica; en caso contrario, la pertenencia es estática.

Devuelto de forma predeterminada. Admite $filter (eq, not).
hasMembersWithLicenseErrors Boolean Indica si hay miembros de este grupo que tienen errores de licencia de la asignación de licencias basada en grupos.

Esta propiedad no se devuelve nunca en una operación GET. Puede usarse como argumento de $filter para obtener grupos que tienen miembros con errores de licencia (es decir, el filtro de esta propiedad es true). Ver un ejemplo.

Admite $filter (eq).
hideFromAddressLists Boolean "True" si el grupo no se muestra en determinadas partes de la interfaz de usuario de Outlook: en la Libreta de direcciones, en las listas de direcciones para seleccionar destinatarios de mensajes y en el cuadro de diálogo Explorar grupos para buscar grupos. De lo contrario, es "False". El valor predeterminado es false.

Solo se devuelve en $select. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
hideFromOutlookClients Boolean "True" si el grupo no se muestra en los clientes de Outlook, como Outlook para Windows y Outlook en la Web. De lo contrario, "False". El valor predeterminado es false.

Solo se devuelve en $select. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
id String El identificador único del grupo.

Se devuelve de forma predeterminada. Heredado de directoryObject. Clave. No admite valores NULL. Solo lectura.

Admite $filter (eq, ne, not, in).
isArchived Booleano Cuando un grupo está asociado a un equipo, esta propiedad determina si el equipo está en modo de solo lectura.
Para leer esta propiedad, use el punto de conexión /group/{groupId}/team o la API Obtener equipo. Para actualizar esta propiedad, use las API archiveTeam y unarchiveTeam.
isAssignableToRole Booleano Indica si este grupo puede asignarse o no a un rol de Azure Active Directory. Opcional.

Esta propiedad solo se puede establecer al crear el grupo y es invariable. Si se establece en true, la propiedad securityEnabled también debe establecerse en true y el grupo no puede ser un grupo dinámico (es decir, groupTypes no puede contener DynamicMembership). Solo los roles de Administrador global y Administrador con roles con privilegios pueden establecer esta propiedad. Al autor de la llamada se le debe asignar el permiso RoleManagement.ReadWrite.Directory para establecer esta propiedad o actualizar la pertenencia de dichos grupos. Para más, consulte Usar un grupo para administrar las asignaciones de roles de Azure AD.

Devuelto de forma predeterminada. Admite $filter (eq, ne, not).
isSubscribedByMail Booleano Indica si el usuario que ha iniciado sesión está suscrito para recibir conversaciones de correo electrónico. El valor predeterminado es true.

Solo se devuelve en $select. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
licenseProcessingState String Indica el estado de la asignación de licencias de grupo a todos los miembros del grupo. El valor predeterminado es false. Solo lectura. Valores posibles: QueuedForProcessing, ProcessingInProgress y ProcessingComplete.

Solo se devuelve en $select. Solo lectura.
mail Cadena La dirección SMTP del grupo, por ejemplo: "serviceadmins@contoso.onmicrosoft.com".

Se devuelve de forma predeterminada. Solo lectura. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
mailEnabled Booleano Especifica si el grupo está habilitado para correo. Obligatorio.

Devuelto de forma predeterminada. Admite $filter (eq, ne, not).
mailNickname Cadena El alias de correo para el grupo, único para los grupos de Microsoft 365 en la organización. La longitud máxima es de 64 caracteres. Esta propiedad solo puede contener caracteres incluidos en el juego de caracteres ASCII de 0 a 127 con estas excepciones: @ () \ [] " ; : . <> , SPACE.

Obligatorio. Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
membershipRule String Regla que determina los miembros de este grupo si el grupo es un grupo dinámico (groupTypes contiene DynamicMembership). Para más información sobre la sintaxis de la regla de pertenencia, consulte Sintaxis de las reglas de pertenencia

Devuelto de forma predeterminada. Admite $filter (eq, ne, not, ge, le, startsWith).
membershipRuleProcessingState String Indica si el procesamiento de pertenencia dinámica está activado o en pausa. Los valores posibles son On o Paused.

Devuelto de forma predeterminada. Admite $filter (eq, ne, not, in).
onPremisesLastSyncDateTime DateTimeOffset Indica la última vez que el grupo se sincronizó con el directorio local. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 sería: 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Solo lectura. Admite $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors Colección OnPremisesProvisioningError Errores al usar el producto de sincronización de Microsoft durante el aprovisionamiento.

Devuelto de forma predeterminada. Admite $filter (eq, not).
onPremisesSamAccountName Cadena Contiene el nombre de cuenta de SAM local sincronizado desde el directorio local. La propiedad se rellena solo para los clientes que sincronizan su directorio local con Azure Active Directory mediante Azure AD Connect.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith). Solo lectura.
onPremisesSecurityIdentifier Cadena Contiene el identificador de seguridad local (SID) del grupo que se sincroniza desde un recurso local a la nube.

Se devuelve de forma predeterminada. Compatibilidad $filter (eq incluidos en null valores). Solo lectura.
onPremisesSyncEnabled Boolean true si este grupo está sincronizado desde un directorio local; false si este grupo se ha sincronizado originalmente desde un directorio local, pero ya no está sincronizado; null si este grupo no se ha sincronizado nunca desde un directorio local (valor predeterminado).

Se devuelve de forma predeterminada. Solo lectura. Admite $filter (eq, ne, not, in y eq en valores null).
preferredDataLocation Cadena Ubicación de datos preferida para el grupo de Microsoft 365. De forma predeterminada, el grupo hereda la ubicación de datos preferida del creador del grupo. Para establecer esta propiedad, se debe asignar al usuario que realiza la llamada uno de los siguientes roles de Azure AD:
  • Administrador global
  • Administrador de cuentas de usuario
  • Escritor de directorios
  • Administrador de Exchange
  • Administrador de SharePoint

Para obtener más información sobre esta propiedad, consulte Multi-Geo de OneDrive Online.

Se devuelve de forma predeterminada. Admite un valor NULL.
preferredLanguage String Idioma preferido para grupos de Microsoft 365. Debe seguir el código ISO 639-1; por ejemplo, en-US.

Se devuelve por defecto. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
proxyAddresses Colección string Direcciones de correo electrónico del grupo que dirigen al mismo buzón del grupo. Por ejemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. El operador any es necesario para filtrar expresiones en propiedades de varios valores.

Se devuelve de forma predeterminada. Solo lectura. No admite valores NULL. Admite $filter (eq, not, ge, le, startsWith, endsWith y contando colecciones vacías).
renewedDateTime DateTimeOffset Marca de tiempo de la última vez que se renovó el grupo. Esto no se puede modificar directamente y solo se actualiza a través de la acción de servicio de renovación. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in). Solo lectura.
resourceBehaviorOptions Colección de cadenas Especifica los comportamientos de grupo que se pueden establecer para un grupo de Microsoft 365 durante su creación. Solo puede establecerse como parte de la creación (POST). Los valores posibles son: AllowOnlyMembersToPost, HideGroupInOutlook, SubscribeNewGroupMembers y WelcomeEmailDisabled. Para obtener más información, vea establecer las opciones de aprovisionamiento y los comportamientos de grupo de Microsoft 365.
resourceProvisioningOptions Colección de cadenas Especifica los recursos de grupo que se aprovisionan como parte de la creación de grupos de Microsoft 365, que normalmente no forman parte de la creación de grupos predeterminada. El valor posible es Team. Para obtener más información, vea establecer las opciones de aprovisionamiento y los comportamientos de grupo de Microsoft 365.
securityEnabled Booleano Especifica si el grupo es un grupo de seguridad. Obligatorio.

Devuelto de forma predeterminada. Admite $filter (eq, ne, not, in).
securityIdentifier Cadena Identificador de seguridad del grupo, que se usa en escenarios de Windows.

Se devuelve de forma predeterminada.
theme string Especifica el tema de color de un grupo de Microsoft 365. Los valores posibles son Teal, Purple, Green, Blue, Pink, Orange o Red.

Se devuelve de forma predeterminada.
unseenCount Int32 Recuento de las conversaciones que han recibido nuevas entradas desde que el usuario que inició sesión visitó el grupo por última vez.

Solo se devuelve en $select. Solo se admite en la API Obtener grupo (GET /groups/{ID}).
visibility Cadena Especifica la directiva de combinación de grupos y la visibilidad del contenido del grupo para los grupos. Los valores posibles son Private, Public o HiddenMembership. HiddenMembership solo puede establecerse para grupos de Microsoft 365 cuando se crean. No se puede actualizar más adelante. Es posible actualizar otros valores de visibilidad después de crear grupos.
Si no se especifica el valor de visibilidad durante la creación de grupos en Microsoft Graph, se creará un grupo de seguridad como Private de forma predeterminada y el grupo de Microsoft 365 es Public. Los grupos a los que se pueden asignar roles siempre son Private. Vea Opciones de visibilidad del grupo para obtener más información.

Se devuelve de forma predeterminada. Admite valores NULL.

Opciones de visibilidad del grupo

Valor Descripción
Public Cualquier usuario puede unirse al grupo sin necesidad de permisos de propietario.
Todos pueden ver los atributos del grupo.
Todos pueden ver los miembros del grupo.
Private Se necesita el permiso del propietario para unirse al grupo.
Cualquier usuario puede ver los atributos del grupo.
Todos pueden ver los miembros del grupo.
HiddenMembership Se necesita el permiso del propietario para unirse al grupo.
Cualquier usuario puede ver los atributos del grupo.
Cualquier usuario puede ver los miembros del grupo.
Los administradores (global, empresa, usuarios y soporte técnico) pueden ver la pertenencia del grupo.
El grupo aparece en la lista global de direcciones (LGD).

Relaciones

Relación Tipo Descripción
acceptedSenders Colección directoryObject La lista de usuarios o grupos que tienen permiso para crear publicaciones o eventos de calendario en este grupo. Si esta lista no está vacía, solo pueden publicar los usuarios o grupos enumerados en ella.
appRoleAssignments Colección appRoleAssignment Representa los roles de aplicación que se le han otorgado a un grupo para una aplicación. Admite $expand.
calendar calendario El calendario del grupo. Solo lectura.
calendarView Colección event La vista Calendario del calendario. Solo lectura.
conversations Colección conversation Las conversaciones del grupo.
createdOnBehalfOf directoryObject El usuario (o la aplicación) que creó el grupo. NOTA: No se establece si el usuario es un administrador. Solo lectura.
Unidad drive Unidad predeterminada del grupo. Solo lectura.
drives Colección drive Las unidades del grupo. Solo lectura.
eventos Colección event Los eventos de calendario del grupo.
extensions Colección Extension La colección de extensiones abiertas definidas para el grupo. Solo lectura. Admite un valor NULL.
groupLifecyclePolicies Colección groupLifecyclePolicy La colección de directivas de ciclo de vida de este grupo. Solo lectura. Admite valores NULL.
memberOf Colección directoryObject Grupos a los que pertenece este grupo. Métodos HTTP: GET (compatible con todos los grupos). Solo lectura. Admite valores NULL. Admite $expand.
members Colección directoryObject Los miembros de este grupo, que pueden ser usuarios, dispositivos, otros grupos o entidades de servicio. Admite las operaciones Lista de miembros, Agregar miembros, y Quitar miembros. Admite un valor NULL.
Compatibilidad $expand incluidos los anidados$select. Por ejemplo, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName).
membersWithLicenseErrors Colección User Una lista de miembros del grupo con errores de licencia de esta asignación de licencias basadas en grupos. Solo lectura.
onenote OneNote Solo lectura.
owners Colección directoryObject Los propietarios del grupo. Limitado a 100 propietarios. Admite un valor NULL. Si no se especifica esta propiedad al crear un grupo de Microsoft 365, el usuario que realiza la llamada se asigna automáticamente como propietario del grupo.
Compatibilidad $expand incluidos los anidados$select. Por ejemplo, /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).
permissionGrants resourceSpecificPermissionGrant El permiso que se ha concedido para un grupo a una aplicación específica. Admite $expand.
photo profilePhoto La foto de perfil del grupo.
photos Colección profilePhoto Las fotos de perfil que pertenecen al grupo. Solo lectura. Admite valores NULL.
planner plannerGroup Punto de entrada al recurso de Planner que puede existir para un grupo unificado.
rejectedSenders Colección directoryObject La lista de usuarios o grupos que no tienen permiso para crear publicaciones o eventos de calendario en este grupo. Admite valores NULL
configuración Colección de groupSetting Configuración que puede regir el comportamiento del grupo, por ejemplo, si los miembros pueden invitar a usuarios al grupo. Admite valores NULL.
sites Colección site La lista de sitios de SharePoint de este grupo. Acceda al sitio predeterminado con /sites/root.
team Colección channel El equipo asociado a este grupo.
threads Colección conversationThread Los hilos de conversación del grupo. Admite valores NULL.
transitiveMemberOf Colección directoryObject Los grupos de los que un grupo es miembro, ya sea directamente o a través de la pertenencia anidada. Admite un valor NULL.
transitiveMembers Colección directoryObject Los miembros directos y transitivos de un grupo. Admite valores NULL.

Representación JSON

Esta es una representación JSON del recurso.

{
  "allowExternalSenders": false,
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "autoSubscribeNewMembers": true,
  "classification": "String",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "groupTypes": ["String"],
  "hasMembersWithLicenseErrors": "Boolean",
  "hideFromAddressLists": false,
  "hideFromOutlookClients": false,
  "id": "String (identifier)",
  "isSubscribedByMail": true,
  "isAssignableRole": false,
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": true,
  "mailNickname": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": true,
  "securityIdentifier": "String",
  "unseenCount": 1024,
  "visibility": "String",
  "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [{ "@odata.type": "microsoft.graph.event" }],
  "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }]
}

Vea también