Microsoft GraphでOutlookカレンダーAPIを始める完全ガイド

2026年6月12日

お得なお知らせ

スポンサードリンク

タイプ別にすぐ選べる

2026年、ビジネス競争力を上げる2ルート

"組織を動かす"立場と"個人スキルを伸ばす"立場では必要な打ち手が違います。自分の役割で選んでください。

▷ 部門・全社でAIリテラシー研修を入れたい管理職・人事・経営層

【Kindle本】イノベーションOps　組織を動かすDX&AI導入プロセスのすべて

▷ 個人のビジネススキル・思考法を"本から"底上げしたい実務担当者

Kindle Unlimited 30日無料｜ビジネス書読み放題▶

※積極的な自己学習が成長への近道です

▶ 耳で学ぶビジネススキルならオーディオブックAudible 。日経BP・東洋経済系の話題作も対象です。

Contents

1 1. エンドポイントと権限モデル
- 1.1 1‑1. 主なエンドポイント
- 1.2 1‑2. 公式ドキュメント参照
2 2. Azure AD アプリ登録と権限設定
3 3. OAuth 2.0 認証フローと MSAL によるトークン取得
4 4. Microsoft Graph SDK を用いたカレンダー操作
- 4.1 4‑1. Node.js 用 SDK（@microsoft/microsoft-graph-client）
  - 4.1.1 初期化とアクセストークン注入
  - 4.1.2 主な操作サンプル（イベント取得・作成・更新・削除）
- 4.2 4‑2. .NET 用 SDK（Microsoft.Graph）
  - 4.2.1 クライアント生成（Key Vault からシークレット取得例）
  - 4.2.2 カレンダー操作サンプル
5 5. デプロイ・エラーハンドリング・セキュリティ最適化
6 まとめ

スポンサードリンク

1. エンドポイントと権限モデル

Microsoft Graph はリソースごとに スコープ（権限）でアクセス制御を行います。カレンダー操作には Calendars.Read / Calendars.ReadWrite が代表的です。

1‑1. 主なエンドポイント

以下の表は代表的な Outlook カレンダー API エンドポイントとその用途です。

HTTP メソッド	エンドポイント例	用途
`GET`	`/me/events`	ログインユーザーの全イベント取得
`POST`	`/users/{id}/events`	指定ユーザーに新規イベント作成
`PATCH`	`/me/events/{event-id}`	イベント情報の更新
`DELETE`	`/me/events/{event-id}`	イベント削除

ポイント
- 読み取りだけなら Calendars.Read、書き込みが必要な場合は必ず Calendars.ReadWrite を付与してください。
- 権限は Azure AD のアプリ登録画面で Application permissions（アプリ単位）または Delegated permissions（ユーザー委任）として設定できます。

1‑2. 公式ドキュメント参照

エンドポイントの最新仕様やパラメータ詳細は Microsoft の公式リファレンスをご確認ください。
- Microsoft Graph イベント API (v1.0)

2. Azure AD アプリ登録と権限設定

アプリから Graph を呼び出すには、Azure Active Directory にアプリケーション登録が必要です。ここでは安全な構成手順を示します。

2‑1. アプリ ID とテナント ID の取得

Azure Portal → Azure Active Directory → App registrations → New registration
名前・サポート対象（例: Single tenant）とリダイレクト URI を入力し作成
作成後に表示される Application (client) ID と Directory (tenant) ID をメモ

ポイント：取得した ID はコード中に直書きせず、環境変数や Azure Key Vault に保存して参照してください。

2‑2. クライアントシークレットの生成と管理

アプリ登録画面の Certificates & secrets → New client secret を作成
有効期限は組織ポリシーに合わせて設定し、表示されたシークレット値を必ず保存（再取得不可）
API permissions タブで Calendars.ReadWrite（アプリケーション権限）を追加し、管理者が Grant admin consent を実行

注意喚起：サンプルコード中に <YOUR_CLIENT_SECRET> などのプレースホルダーが残らないよう、実装時は必ずシークレット取得ロジック（例: Key Vault）へ置き換えてください。

2‑3. 権限付与のベストプラクティス

必要最小限のスコープだけを選択し、不要な権限は削除
定期的にシークレットのローテーションを実施（Key Vault の自動ローテーション機能が便利）

3. OAuth 2.0 認証フローと MSAL によるトークン取得

ユーザー委任でカレンダー操作を行う場合は Authorization Code Grant が推奨されます。Microsoft Authentication Library (MSAL) を利用すると実装が大幅に簡素化できます。

3‑1. Authorization Code Flow の概要

アプリが loginRedirect（または loginPopup）で Azure AD にサインイン要求
ユーザー認証後、Azure AD が 認可コード をリダイレクト URI に返す
MSAL が認可コードから アクセストークン と リフレッシュトークン を取得

ポイント：サーバー側でクライアントシークレットを保持することで、ブラウザ上に機密情報が漏れるリスクを防げます。

3‑2. JavaScript（SPA）実装例

import * as msal from &quot;@azure/msal-browser&quot;;

const msalConfig = {
  auth: {
    clientId: process.env.REACT_APP_CLIENT_ID,          // 環境変数参照
    authority: `https://login.microsoftonline.com/${process.env.REACT_APP_TENANT_ID}`,
    redirectUri: &quot;http://localhost:3000/auth/callback&quot;,
  },
};

const loginRequest = {
  scopes: [&quot;Calendars.ReadWrite&quot;],
};

const msalInstance = new msal.PublicClientApplication(msalConfig);

// サインイン開始
msalInstance.loginRedirect(loginRequest);

import * as msal from "@azure/msal-browser";

const msalConfig = {

auth: {

clientId: process.env.REACT_APP_CLIENT_ID, // 環境変数参照

authority: `https://login.microsoftonline.com/${process.env.REACT_APP_TENANT_ID}`,

redirectUri: "http://localhost:3000/auth/callback",

};

const loginRequest = {

scopes: ["Calendars.ReadWrite"],

};

const msalInstance = new msal.PublicClientApplication(msalConfig);

// サインイン開始

msalInstance.loginRedirect(loginRequest);

注意：process.env.* はビルド時に環境変数から注入され、コード内にシークレットがハードコーディングされません。

3‑3. トークンリフレッシュ（サーバー側）

MSAL の acquireTokenSilent がキャッシュを自動利用し、失敗した場合は対話的取得へフォールバックします。以下は .NET の例です。

var app = ConfidentialClientApplicationBuilder.Create(Environment.GetEnvironmentVariable(&quot;CLIENT_ID&quot;))
    .WithClientSecret(Environment.GetEnvironmentVariable(&quot;CLIENT_SECRET&quot;))
    .WithAuthority(AzureCloudInstance.AzurePublic, Environment.GetEnvironmentVariable(&quot;TENANT_ID&quot;))
    .Build();

string[] scopes = new[] { &quot;https://graph.microsoft.com/.default&quot; };

AuthenticationResult result;
try
{
    // サイレント取得（キャッシュがあれば再利用）
    result = await app.AcquireTokenSilent(scopes, account).ExecuteAsync();
}
catch (MsalUiRequiredException)
{
    // キャッシュが無い場合はクライアント資格情報フローへフォールバック
    result = await app.AcquireTokenForClient(scopes).ExecuteAsync();
}

var app = ConfidentialClientApplicationBuilder.Create(Environment.GetEnvironmentVariable("CLIENT_ID"))

.WithClientSecret(Environment.GetEnvironmentVariable("CLIENT_SECRET"))

.WithAuthority(AzureCloudInstance.AzurePublic, Environment.GetEnvironmentVariable("TENANT_ID"))

.Build();

string[] scopes = new[] { "https://graph.microsoft.com/.default" };

AuthenticationResult result;

try

{

// サイレント取得（キャッシュがあれば再利用）

result = await app.AcquireTokenSilent(scopes, account).ExecuteAsync();

}

catch (MsalUiRequiredException)

{

// キャッシュが無い場合はクライアント資格情報フローへフォールバック

result = await app.AcquireTokenForClient(scopes).ExecuteAsync();

}

4. Microsoft Graph SDK を用いたカレンダー操作

SDK は HTTP 呼び出しの細部を抽象化し、型安全かつエラーハンドリングが組み込まれたクライアントを提供します。

4‑1. Node.js 用 SDK（@microsoft/microsoft-graph-client）

初期化とアクセストークン注入

import { Client } from &quot;@microsoft/microsoft-graph-client&quot;;
import &quot;isomorphic-fetch&quot;;

export function getGraphClient(accessToken) {
  return Client.init({
    authProvider: (done) =&gt; done(null, accessToken),
  });
}

import { Client } from "@microsoft/microsoft-graph-client";

import "isomorphic-fetch";

export function getGraphClient(accessToken) {

return Client.init({

authProvider: (done) => done(null, accessToken),

});

}

主な操作サンプル（イベント取得・作成・更新・削除）

// イベント一覧取得（上位10件）
async function listEvents(client) {
  const resp = await client.api(&quot;/me/events&quot;)
    .select(&quot;subject,start,end,location&quot;)
    .orderby(&quot;start/dateTime&quot;)
    .top(10)
    .get();
  return resp.value;
}

// 新規イベント作成（繰り返し設定付き）
async function createEvent(client) {
  const newEvent = {
    subject: &quot;週次チームミーティング&quot;,
    start: { dateTime: &quot;2025-01-06T10:00:00&quot;, timeZone: &quot;Asia/Tokyo&quot; },
    end:   { dateTime: &quot;2025-01-06T11:00:00&quot;, timeZone: &quot;Asia/Tokyo&quot; },
    recurrence: {
      pattern: { type: &quot;weekly&quot;, interval: 1, daysOfWeek: [&quot;Monday&quot;] },
      range: { type: &quot;endDate&quot;, startDate: &quot;2025-01-06&quot;, endDate: &quot;2025-12-31&quot; }
    },
    location: { displayName: &quot;オンライン会議室&quot; }
  };
  return await client.api(&quot;/me/events&quot;).post(newEvent);
}

// イベント更新
async function updateEvent(client, eventId) {
  const updates = { subject: &quot;[更新] 週次チームミーティング&quot; };
  return await client.api(`/me/events/${eventId}`).update(updates);
}

// イベント削除
async function deleteEvent(client, eventId) {
  return await client.api(`/me/events/${eventId}`).delete();
}

// イベント一覧取得（上位10件）

async function listEvents(client) {

const resp = await client.api("/me/events")

.select("subject,start,end,location")

.orderby("start/dateTime")

.top(10)

.get();

return resp.value;

}

// 新規イベント作成（繰り返し設定付き）

async function createEvent(client) {

const newEvent = {

subject: "週次チームミーティング",

start: { dateTime: "2025-01-06T10:00:00", timeZone: "Asia/Tokyo" },

end: { dateTime: "2025-01-06T11:00:00", timeZone: "Asia/Tokyo" },

recurrence: {

pattern: { type: "weekly", interval: 1, daysOfWeek: ["Monday"] },

range: { type: "endDate", startDate: "2025-01-06", endDate: "2025-12-31" }

location: { displayName: "オンライン会議室" }

};

return await client.api("/me/events").post(newEvent);

}

// イベント更新

async function updateEvent(client, eventId) {

const updates = { subject: "[更新] 週次チームミーティング" };

return await client.api(`/me/events/${eventId}`).update(updates);

}

// イベント削除

async function deleteEvent(client, eventId) {

return await client.api(`/me/events/${eventId}`).delete();

}

ポイント：dateTime と timeZone を必ずセットし、タイムゾーン不一致による予定ズレを防ぎます。

4‑2. .NET 用 SDK（Microsoft.Graph）

クライアント生成（Key Vault からシークレット取得例）

using Azure.Identity;
using Azure.Security.KeyVault.Secrets;
using Microsoft.Graph;

// Key Vault からクライアントシークレットを取得
var secretClient = new SecretClient(new Uri(Environment.GetEnvironmentVariable(&quot;KEY_VAULT_URI&quot;)), new DefaultAzureCredential());
KeyVaultSecret kvSecret = await secretClient.GetSecretAsync(&quot;GraphClientSecret&quot;);
string clientSecret = kvSecret.Value;

var credential = new ClientSecretCredential(
    Environment.GetEnvironmentVariable(&quot;TENANT_ID&quot;),
    Environment.GetEnvironmentVariable(&quot;CLIENT_ID&quot;),
    clientSecret);

var graphClient = new GraphServiceClient(credential);

using Azure.Identity;

using Azure.Security.KeyVault.Secrets;

using Microsoft.Graph;

// Key Vault からクライアントシークレットを取得

var secretClient = new SecretClient(new Uri(Environment.GetEnvironmentVariable("KEY_VAULT_URI")), new DefaultAzureCredential());

KeyVaultSecret kvSecret = await secretClient.GetSecretAsync("GraphClientSecret");

string clientSecret = kvSecret.Value;

var credential = new ClientSecretCredential(

Environment.GetEnvironmentVariable("TENANT_ID"),

Environment.GetEnvironmentVariable("CLIENT_ID"),

clientSecret);

var graphClient = new GraphServiceClient(credential);

カレンダー操作サンプル

// イベント一覧取得（最大20件）
var events = await graphClient.Me.Events
    .Request()
    .Select(e =&gt; new { e.Subject, e.Start, e.End, e.Location })
    .OrderBy(&quot;start/dateTime&quot;)
    .Top(20)
    .GetAsync();

// 新規イベント作成（繰り返し設定付き）
var newEvent = new Event
{
    Subject = &quot;週次チームミーティング&quot;,
    Start   = new DateTimeTimeZone { DateTime = &quot;2025-01-06T10:00:00&quot;, TimeZone = &quot;Asia/Tokyo&quot; },
    End     = new DateTimeTimeZone { DateTime = &quot;2025-01-06T11:00:00&quot;, TimeZone = &quot;Asia/Tokyo&quot; },
    Recurrence = new PatternedRecurrence
    {
        Pattern = new RecurrencePattern
        {
            Type = RecurrencePatternType.Weekly,
            Interval = 1,
            DaysOfWeek = new[] { DayOfWeek.Monday }
        },
        Range = new RecurrenceRange
        {
            Type = RecurrenceRangeType.EndDate,
            StartDate = DateTime.Parse(&quot;2025-01-06&quot;),
            EndDate   = DateTime.Parse(&quot;2025-12-31&quot;)
        }
    },
    Location = new Location { DisplayName = &quot;オンライン会議室&quot; }
};

await graphClient.Me.Events.Request().AddAsync(newEvent);

// イベント一覧取得（最大20件）

var events = await graphClient.Me.Events

.Request()

.Select(e => new { e.Subject, e.Start, e.End, e.Location })

.OrderBy("start/dateTime")

.Top(20)

.GetAsync();

// 新規イベント作成（繰り返し設定付き）

var newEvent = new Event

{

Subject = "週次チームミーティング",

Start = new DateTimeTimeZone { DateTime = "2025-01-06T10:00:00", TimeZone = "Asia/Tokyo" },

End = new DateTimeTimeZone { DateTime = "2025-01-06T11:00:00", TimeZone = "Asia/Tokyo" },

Recurrence = new PatternedRecurrence

{

Pattern = new RecurrencePattern

{

Type = RecurrencePatternType.Weekly,

Interval = 1,

DaysOfWeek = new[] { DayOfWeek.Monday }

Range = new RecurrenceRange

{

Type = RecurrenceRangeType.EndDate,

StartDate = DateTime.Parse("2025-01-06"),

EndDate = DateTime.Parse("2025-12-31")

}

Location = new Location { DisplayName = "オンライン会議室" }

};

await graphClient.Me.Events.Request().AddAsync(newEvent);

ポイント：PatternedRecurrence による繰り返し設定は、業務で頻繁に利用されるシナリオです。型安全なモデルがコンパイル時にミスを防止します。

5. デプロイ・エラーハンドリング・セキュリティ最適化

ローカル検証後は Azure Functions や App Service にデプロイし、運用上の課題（レートリミットや例外処理）に備えます。

5‑1. デプロイ手順（Azure Functions の例）

GitHub リポジトリにコードをプッシュ → main ブランチがデプロイ対象
Azure Portal の Function App → Deployment Center で「GitHub」連携、ビルドは Node.js 20（または .NET 7）を選択
Configuration に環境変数 CLIENT_ID・TENANT_ID・KEY_VAULT_URI を設定し、Function のマネージド ID に Key Vault の「Get」権限を付与

デプロイ完了後は Azure Monitor と Application Insights でリクエストログや例外トレースを確認できます。

5‑2. レートリミットと再試行ロジック

Microsoft Graph はテナント規模やプランに応じて 1 分間あたり最大 10,000 リクエスト（変動あり）という上限が設定されています。公式のスロットリングガイドラインは以下です。
- Graph API のスロットリングとレートリミット

再試行実装例（指数バックオフ）

Node.js

const MAX_RETRY = 5;
async function withRetry(fn, attempt = 0) {
  try {
    return await fn();
  } catch (err) {
    if (err.statusCode === 429 &amp;&amp; attempt &lt; MAX_RETRY) {
      const delaySec = Math.pow(2, attempt); // 1,2,4,8,...
      console.warn(`Rate limit hit. retry after ${delaySec}s`);
      await new Promise(r =&gt; setTimeout(r, delaySec * 1000));
      return withRetry(fn, attempt + 1);
    }
    throw err;
  }
}

const MAX_RETRY = 5;

async function withRetry(fn, attempt = 0) {

try {

return await fn();

} catch (err) {

if (err.statusCode === 429 && attempt < MAX_RETRY) {

const delaySec = Math.pow(2, attempt); // 1,2,4,8,...

console.warn(`Rate limit hit. retry after ${delaySec}s`);

await new Promise(r => setTimeout(r, delaySec * 1000));

return withRetry(fn, attempt + 1);

}

throw err;

}

int retries = 0;
while (true)
{
    try
    {
        return await graphClient.Me.Events.Request().GetAsync();
    }
    catch (ServiceException ex) when (ex.StatusCode == System.Net.HttpStatusCode.TooManyRequests &amp;&amp; retries &lt; 5)
    {
        int backoff = (int)Math.Pow(2, retries) * 1000; // ms
        await Task.Delay(backoff);
        retries++;
    }
}

int retries = 0;

while (true)

{

try

{

return await graphClient.Me.Events.Request().GetAsync();

}

catch (ServiceException ex) when (ex.StatusCode == System.Net.HttpStatusCode.TooManyRequests && retries < 5)

{

int backoff = (int)Math.Pow(2, retries) * 1000; // ms

await Task.Delay(backoff);

retries++;

}

5‑3. 最小権限の原則と機密情報管理

最小権限：Calendars.ReadWrite のみ付与し、不要なスコープは除外
シークレット保管：Azure Key Vault に暗号化保存し、コードからは名前だけを環境変数で参照
ローテーション：Key Vault の自動ローテーション機能か CI パイプラインで定期的に更新

ポイント：シークレットが漏洩した場合でも Azure の監査ログで即座に検知でき、アクセス制御を迅速に変更できます。

まとめ

Microsoft Graph のカレンダー API は /me/events 系エンドポイントと Calendars.Read* スコープで操作可能
Azure AD にアプリ登録し、シークレットは Key Vault 経由で安全に管理することが必須
MSAL を使った Authorization Code Flow が推奨され、トークン取得・リフレッシュはライブラリに任せられる
SDK（Node.js / .NET）を利用すればコードは簡潔になり、型安全と自動エラーハンドリングが得られる
本番環境ではレートリミット対策として指数バックオフ実装と Azure の監視・ロギングを活用し、最小権限で運用することがセキュリティ上のベストプラクティスです。

これらのポイントを踏まえて実装すれば、信頼性と保守性に優れた Outlook カレンダー連携サービスを構築できます。

スポンサードリンク

お得なお知らせ

スポンサードリンク

タイプ別にすぐ選べる

2026年、ビジネス競争力を上げる2ルート

"組織を動かす"立場と"個人スキルを伸ばす"立場では必要な打ち手が違います。自分の役割で選んでください。

▷ 部門・全社でAIリテラシー研修を入れたい管理職・人事・経営層

【Kindle本】イノベーションOps　組織を動かすDX&AI導入プロセスのすべて

▷ 個人のビジネススキル・思考法を"本から"底上げしたい実務担当者

Kindle Unlimited 30日無料｜ビジネス書読み放題▶

※積極的な自己学習が成長への近道です

▶ 耳で学ぶビジネススキルならオーディオブックAudible 。日経BP・東洋経済系の話題作も対象です。

-OutlookCalendar

comment コメントをキャンセル

: OutlookCalendar

Outlook カレンダーのリマインダー設定方法と活用術

Outlook カレンダーのリマインダー機能は、予定やミーティングを忘れることを防ぐための実用的なツールです。ポップアップ通知やメールアラームでタイミングを指定し、作業ミス防止と時間管理に役立ちます。

: OutlookCalendar

Outlook のスケジュールアシスタント活用法：カレンダー連携とAI提案で会議設定を自動化

本稿では、Outlook のスケジュールアシスタントが組織内共有カレンダーやリソースと連携して最適な会議日時・会議室を自動提案する仕組みと、設定手順、外部参加者への対応、AI 提案機能の活用例、さらに導入効果を測る KPI までを包括的に解説します。

: OutlookCalendar

OutlookとTeams連携の手順と最短チェックリスト

Outlookカレンダー（Exchange）を単一ソースとする前提で、Outlook/Teamsでの会議作成手順、よくある不具合の対処、管理者向けチェックリストを短時間で確認する実務ガイド。

: OutlookCalendar

2026年版 Outlook カレンダー移行と活用ガイド：設定・AI Copilot・自動化

この記事では、2026年版 Outlook カレンダーへのスムーズな移行方法と、基本操作から AI Copilot、Teams・Planner連携、Power Automate自動化までを具体的に解説します。

: OutlookCalendar

iPhoneでOutlookアカウントを追加しカレンダー同期する方法

iPhoneの設定アプリでOutlookアカウントを追加し、ネイティブカレンダーへの同期やバックグラウンド更新までをステップバイステップで紹介。

Drivvo無料アカウント登録・車両管理・費用記録の方法

Patreon支援者特典の作り方｜高解像度素材・NFT活用術

Microsoft GraphでOutlookカレンダーAPIを始める完全ガイド

1. エンドポイントと権限モデル

1‑1. 主なエンドポイント

1‑2. 公式ドキュメント参照

2. Azure AD アプリ登録と権限設定

2‑1. アプリ ID とテナント ID の取得

2‑2. クライアントシークレットの生成と管理

2‑3. 権限付与のベストプラクティス

3. OAuth 2.0 認証フローと MSAL によるトークン取得

3‑1. Authorization Code Flow の概要

3‑2. JavaScript（SPA）実装例

3‑3. トークンリフレッシュ（サーバー側）

4. Microsoft Graph SDK を用いたカレンダー操作

4‑1. Node.js 用 SDK（@microsoft/microsoft-graph-client）

初期化とアクセストークン注入

主な操作サンプル（イベント取得・作成・更新・削除）

4‑2. .NET 用 SDK（Microsoft.Graph）

クライアント生成（Key Vault からシークレット取得例）

カレンダー操作サンプル

5. デプロイ・エラーハンドリング・セキュリティ最適化

5‑1. デプロイ手順（Azure Functions の例）

5‑2. レートリミットと再試行ロジック

再試行実装例（指数バックオフ）

5‑3. 最小権限の原則と機密情報管理

まとめ

3. OAuth 2.0 認証フローと MSAL によるトークン取得