Usar a API REST do Microsoft Graph de um suplemento do Outlook

A API JavaScript do Outlook (Office.js) recupera as propriedades de mensagens e compromissos e executa operações nesses itens em seu suplemento. No entanto, pode haver instâncias em que os dados necessários não estejam disponíveis por meio da API. Por exemplo, seu suplemento pode precisar implementar o logon único ou identificar mensagens na caixa de correio de um usuário originadas do mesmo remetente. Para obter as informações necessárias, use a API REST de email do Outlook por meio do Microsoft Graph.

Introdução

Para chamar o Microsoft Graph do suplemento, implemente a solução NAA (autenticação de aplicativo aninhada) para obter um token de acesso. O NAA usa a MSAL (Biblioteca de Autenticação da Microsoft) para adquirir silenciosamente um token para o usuário conectado sem exigir um redirecionamento para uma página de entrada. O token tem como escopo os pontos de extremidade da API do Graph Microsoft de que seu suplemento precisa.

Chamar a API do Microsoft Graph

Depois de ter um token de acesso, use-o para chamar o Microsoft Graph passando-o como um token de portador no Authorization cabeçalho.

A API do Graph Microsoft usa o padrão de ponto de extremidade a seguir.

• version especifica v1.0 (estável) ou beta (versão prévia).
• resource Especifica o recurso com o qual seu suplemento interage, como um usuário, grupo ou site.
• query_parameters são parâmetros opcionais para filtrar, classificar ou paginar resultados.

https://graph.microsoft.com/[version]/[resource]?[query_parameters]

O exemplo a seguir mostra como obter as mensagens do usuário conectado usando a API de Busca depois de adquirir um token de acesso.

// Call the Microsoft Graph API to get the user's messages.
const response = await fetch('https://graph.microsoft.com/v1.0/me/messages', {
    headers: {
        'Authorization': 'Bearer ' + accessToken
    }
});
const data = await response.json();
console.log(data.value); // Array of message objects

Para obter mais informações sobre a API do Graph Microsoft e seus componentes, consulte Usar a API do Graph.

Confira também

• Referência do ponto de extremidade do Microsoft Graph v1.0 API REST
• Visão geral da API de email do Outlook
• Usar a API REST de Email do Outlook
• Habilitar o SSO em um Suplemento do Office usando a autenticação de aplicativo aninhado