Table of contents
TOC
Collapse the table of content
Expand the table of content
Última actualización: 20/06/2018

Usar Visual Studio para registrar su aplicación y agregar las API de Office 365

Se aplica a: Office 365

Tras configurar su entorno de desarrollo, estará listo para agregar un servicio de la API de Office 365 a su proyecto de Visual Studio.

En este artículo

Cuando agrega un servicio de Office 365 a su proyecto, Visual Studio le ayuda a registrar su aplicación

Los servicios de la API de Office 365 utilizan Azure AD para proporcionar autenticación segura a los datos de Office 365 de los usuarios. Para acceder a las API de Office 365, debe registrar su aplicación con Azure AD.

Si está creando un proyecto de Visual Studio, el registro de la aplicación lo controlará usted al agregar un servicio de Office 365 al proyecto.

Seleccione la versión de Visual Studio que esté utilizando:

Durante el proceso de agregar un servicio de Office 365 a su proyecto, Visual Studio le permite:

  • Registrar su aplicación con Azure AD, incluida la especificación de si es una aplicación web o una aplicación nativa
  • Configurar las propiedades de la aplicación, como su nombre, los extremos de redirección/respuesta y el ámbito del inquilino
  • Registrar su aplicación con Azure AD
  • Conectarse a los servicios de Office 365
  • Especificar los niveles de permisos que requiere su aplicación para las API en esos servicios de Office 365
  • Agregar al proyecto los paquetes NuGet requeridos, conforme a los servicios de Office 365 a los que se conecte su aplicación

Las siguientes plantillas de proyecto admiten agregar las API de Office 365 como un servicio conectado:

  • .NET para aplicaciones de la Tienda Windows 8.1
  • .NET para aplicaciones universales de la Tienda Windows 8.1
  • .NET para aplicaciones de Windows Phone 8.1
  • .NET para aplicaciones Silverlight de Windows Phone 8.1
  • Aplicaciones de Windows Forms
  • Aplicaciones WPF
  • Aplicaciones web ASP.NET MVC
  • Aplicaciones de formularios Web Forms ASP.NET
  • Aplicaciones Xamarin para Android e iOS
  • Aplicaciones híbridas (Cordova) para múltiples dispositivos

Si no tiene un proyecto de Visual Studio existente donde quiera usar las API de Office 365, o si desea probar proyectos completos que utilicen esas API, descargue alguno de los proyectos listados en la página Proyectos de inicio de la API de Office 365 y ejemplos de código.

Requisitos previos para registrar sus aplicaciones con Azure AD usando Visual Studio

Para registrar sus aplicaciones, necesitará:

Usar el administrador de servicios de Visual Studio para registrar su aplicación y agregar las API de Office 365 al proyecto

Agregue y configure las API de Office 365 mediante el Administrador de servicios de Visual Studio.

  1. En el Explorador de la soluciones, elija el nodo del proyecto al que quiera agregar un servicio de Office 365.

  2. Haga clic con el botón derecho o pulse y mantenga pulsado el nodo del proyecto y elija Agregar > Servicio conectado.

  3. Registrar su aplicación:

    En la parte superior del cuadro de diálogo del Administrador de servicios, elija el vínculo Office 365 y luego seleccione Registrar su aplicación. Conéctese con una cuenta de Administrador de inquilinos de su organización de desarrolladores de Office 365.

    Eso inicia el registro de la aplicación en Microsoft Azure Active Directory, lo que permite que su aplicación se autentique a través de OAuth.

    Tras iniciar sesión en Office 365, aparece una lista de servicios disponibles de las API de Office 365. Verá una lista de las API de Office 365.

    También verá que está vacía la columna Permisos situada a la derecha de cada servicio.

  4. Seleccione las API de Office 365 a las que desee conectarse y especifique los niveles de permisos para cada una:

    En la lista:

    1. Seleccione las API de Office 365 que desee agregar
    2. Elija Permisos.

      Una captura de pantalla que muestra el cuadro de diálogo del Administrador de servicios con el servicio de calendario de la API de Office 365 seleccionado y el vínculo de Permisos resaltado.

      En el cuadro de diálogo de Permisos [del servicio de Office 365]:

    3. Elija los permisos que requiere su proyecto

    4. Elija Aplicar.

      Captura de pantalla que muestra el cuadro de diálogo de Permisos del calendario con el permiso de leer los calendarios de usuarios seleccionado.

      Al hacer esto, Visual Studio agrega el servicio o los servicios de Office 365 que contienen las API que seleccionó a su aplicación en Azure AD, y establece como niveles de permisos para las API los que especificó.

  5. Establecer propiedades para su aplicación:

    Elija Propiedades de la aplicación en el cuadro de diálogo del Administrador de servicios.

    Las propiedades de la aplicación que puede establecer varían dependiendo de si su proyecto de aplicación es para un servicio web o una aplicación web, o para una aplicación nativa, como un proyecto para un teléfono móvil.

    Por ejemplo, en el caso de aplicaciones web, para que esa aplicación de muestra esté disponible para organizaciones de Office 365 que no sean su organización de desarrollo:

    1. Cambie la configuración Hacer que esta aplicación esté disponible para: a Múltiples organizaciones
    2. Elija Aplicar.

      Una captura de pantalla del cuadro de diálogo de Propiedades de la aplicación de Office 365 que muestra la configuración a seleccionar para hacer que su aplicación esté disponible para varias organizaciones.

      El cuadro de diálogo del Administrador de servicios lista ahora:

    3. El servicio o los servicios que haya elegido agregar a su proyecto

    4. Los permisos de cada servicio.

      Una captura de pantalla del cuadro de diálogo del Administrador de servicios después de configurar el servicio de calendario, que muestra que ese servicio tiene permisos de lectura.

  6. Elija Aceptar.

En este punto, Visual Studio agrega al proyecto los paquetes NuGet requeridos. Esos paquetes NuGet que se agregan varían según las API de Office 365 que haya agregado usted.

  1. En el Explorador de la soluciones, elija el nodo del proyecto al que quiera agregar un servicio de Office 365.

  2. Haga clic con el botón derecho o pulse y mantenga pulsado el nodo del proyecto y elija Agregar > Servicio conectado.

  3. En la ficha Microsoft, elija las API de Office 365 y luego Configurar.

    Aparece el cuadro de diálogo de Configurar los servicios de la API de Office 365.

  4. Registrar su aplicación:

    En la página Seleccionar dominio, escriba o seleccione el dominio de Office 365 en que desea registrar su aplicación; por ejemplo, contoso.onmicrosoft.com. Elija Siguiente. Quizá se le solicite que inicie sesión en Office 365 si todavía no lo ha hecho.

    En la página Configurar la aplicación, elija crear una nueva aplicación de Azure AD, o use una ya existente. Si elige usar una aplicación de Azure AD que ya existe, escriba la ID de cliente de esa aplicación.

    Si desea utilizar el inicio de sesión único con su aplicación, marque la casilla correspondiente. Dado que el inicio de sesión único requiere SSL, seleccionar esa opción habilita automáticamente SSL en su proyecto.

    Elija Siguiente.

    Visual Studio registra su aplicación.

  5. Seleccione las API de Office 365 a las que desee conectarse y especifique los niveles de permisos para cada una:

    1. Seleccione la API de Office 365; por ejemplo, Contactos o Mis archivos.

    2. Elija el permiso o los permisos que requiera su aplicación.

      Recuerde que los permisos son aditivos respecto a su ámbito. Por ejemplo, en la API de correo, el permiso para leer y escribir el correo incluye el de leer el correo, por lo que no necesita seleccionar ambos. En general, elija el permiso menos amplio que aun así permita que su aplicación consiga hacer todo lo que necesite hacer.

    3. Elija Siguiente.

      Al hacer esto, Visual Studio agrega el servicio o los servicios de Office 365 que contienen las API que seleccionó a su aplicación en Azure AD, y establece como niveles de permisos para las API los que especificó.

  6. Cuando haya agregado todas las API que requiere su aplicación, elija Finalizar.

En este punto, Visual Studio agrega al proyecto los paquetes NuGet requeridos. Esos paquetes NuGet que se agregan varían según las API de Office 365 que haya agregado usted.

Agregar manualmente a su proyecto paquetes NuGet opcionales de la biblioteca cliente de la API de Office 365

Aunque las herramientas de Office 365 agreguen automáticamente los paquetes NuGet necesarios cuando usted agrega un servicio de Office 365, también es posible agregarlos y administrarlos manualmente mediante el cuadro de diálogo de Administrar paquetes NuGet o con la consola del administrador de paquetes NuGet y PowerShell.

La siguiente tabla enumera los paquetes NuGet necesarios en función del servicio API de Office 365 que agregue y el tipo de proyecto que haya creado.

Servicio de Office 365.NET para aplicaciones de la Tienda Windows (Tienda Windows y Windows Phone)Aplicaciones de escritorio de Windows (WPF y Windows Forms)Aplicaciones web ASP.NET (MVC y formularios Web Forms)Aplicaciones de Xamarin (iOS y Android)Aplicaciones Cordova
Usuarios y gráficosMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClient.JS
Servicios de OutlookMicrosoft.Office365.OutlookServicesMicrosoft.Office365.OutlookServicesMicrosoft.Office365.OutlookServicesMicrosoft.Office365.OutlookServices
Servicios de SharePointMicrosoft.Office365.SharePointMicrosoft.Office365.SharePointMicrosoft.Office365.SharePointMicrosoft.Office365.SharePoint
Cliente de descubrimientoMicrosoft.Office365.DiscoveryMicrosoft.Office365.DiscoveryMicrosoft.Office365.DiscoveryMicrosoft.Office365.Discovery
Cualquier servicioMicrosoft.Office365.OAuth.XamarinMicrosoft.Office365.ClientLib.JS

Según el tipo de proyecto, se requieren ciertos paquetes NuGet al agregar cualquier servicio de Office 365:

Xamarin Studio ofrece ahora soporte para administrar paquetes NuGet.

Pasos siguientes

Tras agregar un servicio O365 a su aplicación, deberá autenticarla con Office 365 para obtener acceso a los datos del usuario. Para más detalles, consulte Integrar las API de Office 365 en proyectos .NET de Visual Studio.

© 2018 Microsoft