Agregar aplicación al equipo

Espacio de nombres: microsoft.graph

Instalar una aplicación en el equipo especificado.

Disponibilidad de API

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) TeamsAppInstallation.ReadWriteSelfForTeam1, TeamsAppInstallation.ReadWriteForTeam1, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, Group.ReadWrite.All2, Directory.ReadWrite.All2
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación TeamsAppInstallation.ReadWriteSelfForTeam.All1, TeamsAppInstallation.ReadWriteForTeam.All1, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.ReadWrite.All2, Directory.ReadWrite.All2

Nota:
1 Estos permisos no se pueden usar para instalar aplicaciones que requieran consentimiento a permisos de consentimiento específicos de recursos
2 Estos permisos solo se admiten para la compatibilidad con versiones anteriores. Se recomienda actualizar las soluciones para usar un permiso alternativo y evitar el uso de estos permisos en el futuro.

Solicitud HTTP

POST /teams/{team-id}/installedApps

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.

Cuerpo de la solicitud

El cuerpo de la solicitud debe incluir el id. de aplicación generado de la aplicación de catálogo. Para obtener más información, consulte las propiedades de teamsApp.

En la tabla siguiente se enumeran las propiedades adicionales que se pueden incluir en el cuerpo de la solicitud.

Propiedad Tipo Description
teamsApp Cadena El id. de la aplicación que se va a agregar.
consentedPermissionSet teamsAppPermissionSet Conjunto de permisos específicos de recursos que se están consintiendo.

Nota: Los permisos que se han consentido durante la instalación deben coincidir con los permisos específicos de recursos especificados en teamsAppDefinition de la aplicación. Para obtener los permisos específicos de la aplicación y del recurso delegado, consulte el ejemplo 6. Si solo se especifican permisos específicos de recursos delegados en teamsAppDefinition, los permisos se pueden omitir en el cuerpo de la solicitud.

Respuesta

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

Ejemplos

Ejemplo 1: Instalar una aplicación en un equipo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/teams/87654321-0abc-zqf0-321456789q/installedApps
Content-type: application/json

{
   "teamsApp@odata.bind":"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK

Para obtener la lista de permisos específicos de recursos requeridos por la aplicación, obtenga la aplicación desde appCatalog, como se muestra en el Ejemplo 6.

Solicitud

POST https://graph.microsoft.com/v1.0/teams/7023576d-9e40-47ca-9cf2-daae6838e785/installedApps
Content-Type: application/json

{
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/7023576d-9e40-47ca-9cf2-daae6838e785",
    "consentedPermissionSet": {
        "resourceSpecificPermissions": [
        {
          "permissionValue": "OnlineMeeting.ReadBasic.Chat",
          "permissionType": "delegated"
        },
        {
          "permissionValue": "ChatMessage.Read.Chat",
          "permissionType": "application"
        }]
      }
}

Respuesta

HTTP/1.1 201 Created

Si la llamada da como resultado un mensaje de error que dice The required permissions have not been consented to by the caller, el cuerpo de la solicitud no especifica todos los permisos RSC requeridos por la aplicación a los que el usuario debe otorgar consentimiento. Asegúrese de crear la solicitud como se muestra en el ejemplo.