Actualizar insightsSettings

Espacio de nombres: microsoft.graph

Actualice la configuración de privacidad para mostrar o devolver el tipo de información especificado en una organización. Actualmente, itemInsights es el único tipo de configuración compatible.

Para más información sobre la personalización de la privacidad de insights para su organización, consulte Personalización de la privacidad de las conclusiones de elementos en Microsoft Graph.

Permissions

En las tablas siguientes se muestran los permisos o permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga los procedimientos recomendados para solicitar permisos con privilegios mínimos. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Para actualizar la configuración de itemInsights para una organización

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	PeopleSettings.ReadWrite.All	No disponible.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	PeopleSettings.ReadWrite.All	No disponible.

Nota: El uso de permisos delegados para esta operación para actualizar la información de elementos requiere que el usuario que ha iniciado sesión tenga un rol de administrador global.

Solicitud HTTP

Para actualizar la configuración de la información de elementos:

PATCH /admin/people/itemInsights

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type	application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, únicamente proporcione los valores de las propiedades que deben actualizarse. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Propiedad	Tipo	Descripción
disabledForGroup	Cadena	Identificador de un grupo de Microsoft Entra, del que se deshabilita el tipo de información especificado para sus miembros. El valor predeterminado es empty. Opcional.
isEnabledInOrganization	Booleano	true si el tipo de información especificado está habilitado para la organización; false si el tipo de información especificado está deshabilitado para todos los usuarios sin excepciones. El valor predeterminado es true. Opcional.

Nota: Esta operación no comprueba el valor de la propiedad disabledForGroup si lo incluye en el cuerpo de la solicitud. Si establece la propiedad disabledForGroup en string, esta operación no comprueba la existencia del grupo Microsoft Entra correspondiente. Esto significa que, si establece disabledForGroup en un grupo de Microsoft Entra que no existe o se elimina posteriormente, esta operación no puede identificar ninguna pertenencia a grupos y deshabilitar la información de elementos para usuarios específicos. Si isEnabledInOrganization se establece en true, la operación habilita el tipo de información especificado para todos los usuarios de la organización.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto insightsSettings en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra cómo un administrador actualiza la configuración de privacidad disabledForGroup para evitar la presentación de información de elementos de los usuarios en un grupo de Microsoft Entra determinado.

PATCH https://graph.microsoft.com/v1.0/admin/people/itemInsights
Content-Type: application/json

{
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-type: application/json

{
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}