Outlook アドインから Microsoft Graph REST API を使用する

Outlook JavaScript API (Office.js) は、メッセージと予定のプロパティを取得し、アドイン内のこれらのアイテムに対して操作を実行します。 ただし、必要なデータが API を介して使用できない場合があります。 たとえば、アドインでシングル サインオンを実装したり、同じ送信者から送信されたユーザーのメールボックス内のメッセージを特定したりする必要がある場合があります。 必要な情報を取得するには、Microsoft Graph から Outlook メール REST API を使用します。

開始する

アドインから Microsoft Graph を呼び出すには、 入れ子になったアプリ認証 (NAA) ソリューションを実装してアクセス トークンを取得します。 NAA では、Microsoft Authentication Library (MSAL) を使用して、サインイン ページへのリダイレクトを必要とせずに、サインイン ユーザーのトークンをサイレント で取得します。 トークンのスコープは、アドインで必要な Microsoft Graph API エンドポイントです。

Microsoft Graph API の呼び出し

アクセス トークンを取得したら、それを使用して Microsoft Graph を呼び出し、 Authorization ヘッダーでベアラー トークンとして渡します。

Microsoft Graph APIでは、次のエンドポイント パターンが使用されます。

• version は、 v1.0 (安定) または beta (プレビュー) を指定します。
• resource は、ユーザー、グループ、サイトなど、アドインが操作するリソースを指定します。
• query_parameters は、結果をフィルター処理、並べ替え、またはページ分割するための省略可能なパラメーターです。

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

次の例は、アクセス トークンを取得した後、Fetch API を使用してサインインしているユーザーのメッセージを取得する方法を示しています。

// 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

Microsoft Graph APIとそのコンポーネントの詳細については、「Microsoft Graph APIを使用する」を参照してください。

関連項目

• Microsoft Graph REST API v1.0 エンドポイント リファレンス
• Outlook メール API の概要
• Outlook メール REST API を使用する
• 入れ子になったアプリ認証を使用して Office アドインで SSO を有効にする