Compartir a través de

API REST para la extensibilidad de Teams Phone

En este artículo se describe la API DE REST para la extensibilidad del teléfono de Teams.

Importante

Esta característica de Azure Communication Services se encuentra actualmente en versión preliminar. Las características de la versión preliminar están disponibles públicamente y se pueden usar en todos los clientes nuevos y existentes de Microsoft.

Esta versión preliminar se ofrece sin un Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que las funcionalidades estén restringidas.

Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

Crear tarea

Cree una asignación para conceder a un usuario de Teams o una cuenta de recursos de Teams acceso al recurso de Communication Services.

PUT {endpoint}/access/teamsExtension/tenants/{tenantId}/assignments/{objectId}?api-version=2025-03-02-preview

Parámetros de URI

Nombre En Obligatorio Tipo Descripción
objectId camino cierto cuerda / cadena ID de objeto del principal, es decir, el identificador de usuario o el identificador de cuenta de recurso.
tenantId camino cierto cuerda / cadena Identificador de entidad del arrendatario al que pertenece el principal.
api-version consulta cierto cuerda / cadena Versión de la API que se va a invocar.

Cuerpo de la solicitud

Nombre En Obligatorio Tipo Descripción
request cuerpo cierto TeamsExtensionAssignmentCreateOrUpdateRequest Solicitud de asignación de cuentas de Teams.

Respuestas

Nombre Tipo Descripción
200 Ok TeamsExtensionAssignmentResponse Creado: devuelve la asignación actualizada.
201 Creado TeamsExtensionAssignmentResponse Creado: devuelve la asignación creada.
Otros códigos de estado CommunicationErrorResponse Error.

Obtener tarea

Obtenga la asignación de acceso a un recurso desde un usuario de Teams o una cuenta de recursos de Teams.

GET {endpoint}/access/teamsExtension/assignments/{objectId}?api-version=2025-03-02-preview

Parámetros de URI

Nombre En Obligatorio Tipo Descripción
objectId camino cierto cuerda / cadena ID de objeto del principal, es decir, el identificador de usuario o el identificador de cuenta de recurso.

Respuestas

Nombre Tipo Descripción
200 Ok TeamsExtensionAssignmentResponse Devuelve la asignación.
Otros códigos de estado CommunicationErrorResponse Error.

Eliminar asignación

Elimine la asignación para quitar el acceso a recursos de un usuario de Teams o una cuenta de recursos de Teams.

DELETE {endpoint}/access/teamsExtension/assignments/{objectId}?api-version=2025-03-02-preview

Parámetros de URI

Nombre En Obligatorio Tipo Descripción
objectId camino cierto cuerda / cadena ID de objeto del principal, es decir, el identificador de usuario o el identificador de cuenta de recurso.

Respuestas

Nombre Tipo Descripción
204 Sin Contenido Vacío Código de estado correcto.
Otros códigos de estado CommunicationErrorResponse Error.

Definiciones

Nombre Descripción
CommunicationError Error de Communication Services.
CommunicationErrorResponse Error de Communication Services.
TeamsExtensionAssignmentCreateOrUpdateRequest Solicitud para crear o reemplazar una asignación.
principalType Tipo de principal que accede al recurso, ya sea "user" o "teamsResourceAccount".
TeamsExtensionAssignmentResponse Una asignación de teléfono de Teams.

Error de Comunicación

Nombre Tipo Descripción
code cuerda / cadena Código de error.
details CommunicationError[] Más detalles sobre los errores específicos que llevaron a este error.
innererror CommunicationError Error interno si existe.
message cuerda / cadena El mensaje de error.
target cuerda / cadena Destino del error.

CommunicationErrorResponse

Nombre Tipo Descripción
error CommunicationError Error de Communication Services.

TeamsExtensionAssignmentCreateOrUpdateRequest

Nombre Tipo Descripción
principalType cuerda / cadena Tipo de principal que accede al recurso, ya sea "user" o "teamsResourceAccount".
clientIds string[] Lista de identificadores de las aplicaciones a través de las cuales un "user" principal puede acceder al recurso.

TeamsExtensionAssignmentResponse

Nombre Tipo Descripción
objectId cuerda / cadena Id. de objeto de la entidad de seguridad de la asignación.
tenantId cuerda / cadena Identificador de inquilino.
principalType cuerda / cadena Tipo de principal que accede al recurso, ya sea "user" o "teamsResourceAccount".
clientIds string[] Lista de identificadores de las aplicaciones a través de las cuales un "user" principal puede acceder al recurso.