Compartir a través de


channel: provisionEmail

Espacio de nombres: microsoft.graph

Aprovisionar una dirección de correo electrónico para un canal.

Microsoft Teams no aprovisiona automáticamente una dirección de correo electrónico para un canal de forma predeterminada. Para que Teams aprovisione una dirección de correo electrónico, puede llamar a provisionEmail o, a través de la interfaz de usuario de Teams, seleccione Obtener dirección de correo electrónico, lo que desencadena que Teams genere una dirección de correo electrónico si aún no la ha aprovisionado.

Para quitar la dirección de correo electrónico de un canal, use el método removeEmail .

Notas: Esta API funciona de forma diferente en una o varias nubes nacionales. Para obtener más información, consulte Diferencias de implementación en nubes nacionales.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) ChannelSettings.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

POST /teams/{team-id}/channels/{channel-id}/provisionEmail

Encabezados de solicitud

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

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto provisionChannelEmailResult en el cuerpo de la respuesta. La dirección de correo electrónico aprovisionada está en la email propiedad .

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/provisionEmail

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.provisionChannelEmailResult",
    "email": "contoso.com@amer.teams.ms"
}