Llamar a los servicios de Microsoft 365 en Visual Studio 2017 con la API de Microsoft Graph

Puede utilizar Servicios conectados en Visual Studio a fin de configurar su aplicación para llamar a la API de Microsoft Graph. En este artículo se describe cómo obtener una foto de perfil del usuario que ha iniciado sesión, cargarla en OneDrive y enviar un correo electrónico con un vínculo para compartir a la foto.

Para empezar

Para utilizar los servicios conectados de Office 365 con Microsoft Graph, debe hacer lo siguiente:

  • Descargue Visual Studio 2017 Preview si no lo ha hecho ya. Si está usando una versión anterior de Visual Studio, puede utilizar Visual Studio 2017 Preview en paralelo con la versión actual.

  • Consiga una suscripción a Microsoft 365. Para obtener una versión de prueba gratuita, únase al programa Microsoft 365 Developer.

Obtener el proyecto de inicio

Descargue el ejemplo de Servicios conectados de Microsoft Graph ASP.NET. Este ejemplo incluye las referencias que necesita para autenticarse en Microsoft Graph. Después de descargar el proyecto de inicio, descomprímalo y abra el ejemplo en Visual Studio 2017 Preview.

Agregar el Servicio conectado

Ahora está listo para agregar el servicio de Microsoft Graph a su proyecto de Visual Studio.

  1. En el explorador de soluciones, elija Servicios conectados para abrir la pestaña Servicios conectados.

  2. Elija el proveedor en Acceder a los servicios de Microsoft 365 con Microsoft Graph. Siga las instrucciones del asistente. Seleccione los siguientes permisos (puede cambiar los permisos más adelante):

    • Para las API de File, establezca los permisos en Tener acceso completo a los archivos.
    • Para las API de Mail, establezca los permisos en Enviar correo en su nombre.
    • Para las API de User, establezca los permisos en Iniciar sesión y leer su perfil.

Llamar a la API de Microsoft Graph

El ejemplo de inicio está configurado para enviar un correo electrónico simple. Puede utilizar Microsoft Graph para actualizar el ejemplo y enviar un correo electrónico con un vínculo a la foto de perfil del usuario que ha iniciado sesión en OneDrive.

  1. Vaya a "Models\GraphService.cs", que hospeda el código para llamar a Microsoft Graph.

  2. Busque y quite las marcas de comentarios a las llamadas al SDK en los métodos siguientes. Muestra cómo llamar a Microsoft Graph para obtener una foto de perfil, cargar un archivo en OneDrive y obtener un enlace para compartir.

        GetCurrentUserPhotoStream(GraphServiceClient graphClient)
    
        UploadFileToOneDrive(GraphServiceClient graphClient, byte[] file)
    
        GetSharingLink(GraphServiceClient graphClient, string Id)
    

Sugerencia: Cada comentario empieza con "//Uncomment:"

Ejecutar el ejemplo

Compile y ejecute el ejemplo. Luego, elija el vínculo de inicio de sesión situado en la esquina superior derecha y elija Obtener la dirección de correo electrónico seguido de Enviar correo electrónico.

Esto enviará un correo electrónico que incluya un vínculo a la foto de su perfil.

Notas:

  • Si detiene y vuelve a ejecutar el ejemplo desde Visual Studio, necesitará cerrar la sesión explícitamente para que el ejemplo funcione.
  • Si se muestra una excepción que indica que el usuario no está autenticado, puede que necesite repetir el paso de Agregar el servicio conectado.
  • Asegúrese de iniciar sesión con una cuenta del mismo dominio que la que seleccionó en el Seleccionar dominio del asistente.

Examinar el código

Ahora puede utilizar Visual Studio 2017 para conectarse y configurar los servicios. El ejemplo de inicio crea el scaffolding y las referencias.

El ejemplo de inicio incluye los siguientes archivos:

¿Necesita ayuda?

Si necesita ayuda, publique sus preguntas en Microsoft Q&A. Etiquete su publicación con {microsoft-graph-identity}.