Llamar a los servicios de Office 365 en Visual Studio 2017 con la API de Microsoft GraphCall Office 365 services in Visual Studio 2017 with the Microsoft Graph API

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.You can use the Connected Services in Visual Studio to configure your app to call the Microsoft Graph API. This article describes how to get a signed in user's profile photo, upload it to OneDrive, and send an email with a sharing link to the photo.

Para empezarGet set up

Para utilizar los servicios conectados de Office 365 con Microsoft Graph, debe hacer lo siguiente:To use the Office 365 Connected Services with Microsoft Graph, you'll need to do the following:

  • 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.Download the Visual Studio 2017 Preview, if you haven't already. If you're using an earlier version of Visual Studio, you can use Visual Studio 2017 Preview side by side with your current version.

  • Consiga una suscripción a Microsoft 365. Para obtener una versión de prueba gratuita, únase al programa Microsoft 365 Developer.Get a Microsoft 365 subscription. To get a free trial, join the Microsoft 365 Developer program.

Obtener el proyecto de inicioGet the starter project

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.Download the Microsoft Graph ASP.NET Connected Services Sample. This sample includes the references that you need to authenticate against Microsoft Graph. After you download the starter project, unzip, and open the sample in Visual Studio 2017 Preview.

Agregar el Servicio conectadoAdd the Connected Service

Ahora está listo para agregar el servicio de Microsoft Graph a su proyecto de Visual Studio.You're now ready to add the Microsoft Graph service to your Visual Studio project.

  1. En el explorador de soluciones, elija Servicios conectados para abrir la pestaña Servicios conectados.In Solution Explorer, choose Connected Services to open the Connected Services tab.

  2. Elija el proveedor en Acceder a los servicios de Office 365 con Microsoft Graph.Choose the Access Office 365 Services with Microsoft Graph provider. Siga las instrucciones del asistente.Follow the wizard. Seleccione los siguientes permisos (puede cambiar los permisos más adelante):Select the following permissions (you can change the permissions later):

    • Para las API de File, establezca los permisos en Tener acceso completo a los archivos.For the File APIs, set permissions to Have full access to your files.
    • Para las API de Mail, establezca los permisos en Enviar correo en su nombre.For the Mail APIs, set permissions to Send mail as you.
    • Para las API de User, establezca los permisos en Iniciar sesión y leer su perfil.For the User APIs, set permissions to Sign you in and read your profile.

Llamar a la API de Microsoft GraphCall the Microsoft Graph API

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.The starter sample is configured to send a simple email. You can use Microsoft Graph to update the sample to send an email with a link to the signed-in user's profile photo in OneDrive.

  1. Vaya a "Models\GraphService.cs", que hospeda el código para llamar a Microsoft Graph.Go to 'Models\GraphService.cs', which hosts the code to call 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.Find and Uncomment calls to the SDK in the following methods. This shows how to call Microsoft Graph to get a profile photo, upload a file to OneDrive, and get a sharing link.

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

Sugerencia: Cada comentario empieza con "//Uncomment:"Tip: Each comment starts with '//Uncomment:'

Ejecutar el ejemploRun the sample

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.Build and run the sample. Next, choose the Sign-in link on the top right, and then choose Get email address followed by Send email.

Esto enviará un correo electrónico que incluya un vínculo a la foto de su perfil.This will send an email that includes a link to your profile photo.

Notas:Notes:

  • Si detiene y vuelve a ejecutar el ejemplo desde Visual Studio, necesitará cerrar la sesión explícitamente para que el ejemplo funcione.If you stop and rerun the sample from Visual Studio, you might need to explicitly sign out for the sample to work.
  • 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.If you get an exception that indicates that the User is not authenticated, you might need to repeat the Add the Connected Service step.

Examinar el códigoExplore the code

Ahora puede utilizar Visual Studio 2017 para conectarse y configurar los servicios. El ejemplo de inicio crea el scaffolding y las referencias.You can now use Visual Studio 2017 to connect to and configure your services. The starter sample creates the scaffolding and references for you.

El ejemplo de inicio incluye los siguientes archivos:The starter sample includes the following files:

¿Necesita ayuda?Need help?

Si necesita ayuda, publique sus preguntas en StackOverflow. Etiquete sus preguntas con {microsoftgraph}.If you need help, post your questions on StackOverflow. Tag your post with {microsoftgraph}.