Microsoft Graph には、Microsoft 365、Windows、Enterprise Mobility + Securityのデータにアクセスするために使用できる統合プログラミング モデルが用意されています。 この記事では、Microsoft Graph API、ドキュメント、SDK などの新機能について説明します。
API レベルの更新プログラムの詳細については、Microsoft Graph API変更ログを参照してください。
Microsoft Graph の以前の更新プログラムの詳細については、「 Microsoft Graph の新しい履歴」を参照してください。
重要
プレビュー状態の機能は予告なく変更される可能性があり、一般公開 (GA) 状態に昇格されない場合があります。 運用アプリではプレビュー機能を使用しないでください。
2026 年 3 月: 新規および一般公開
Files
SharePoint Embedded アプリケーションで構造化ファイル ストレージをさらにサポートするために追加された次の新しいコンテナー列 API を使用します。
ID とアクセス | 社内
- アクセス パッケージがすべてのディレクトリ エージェント ID をターゲットにできるように、
allDirectoryAgentIdentitiesメンバーを allowedTargetScope 列挙型に追加しました。 - 特定のエージェント ID のスポンサーまたは所有者を定義する targetAgentIdentitySponsorsOrOwners リソースの種類を追加しました。
2026 年 3 月: プレビュー版のみ
バックアップ ストレージ
includeNewerItems メンバーを restorePoint の tags プロパティでサポートされている値として追加し、指定した期間内に復元ポイントを取得し、その期間中に作成された新しいアイテムを含めます。
ID とアクセス | 社内
特定のエージェント ID のスポンサーまたは所有者を定義する targetAgentIdentitySponsorsOrOwners リソースの種類を追加しました。
ID とアクセス |ネットワーク アクセス
- Global Secure Access トラフィック接続ログで Bring Your Own Device (BYOD) と Business-to-Business (B2B) コラボレーション シナリオをサポートするために、 homeTenantId、 crossTenantAccessType、 deviceJoinType プロパティを 接続 リソースに追加しました。
- crossTenantAccessType 列挙型を追加しました。
- deviceJoinType 列挙型を追加しました。
2026 年 2 月: 新規および一般公開
外部データ接続
Microsoft 365 Copilot コネクタのラベル列挙に 19 人のユーザー ドメイン セマンティック ラベルを追加しました。 これらのラベルを使用すると、開発者は外部システムのユーザー プロファイル データを標準化された Microsoft Graph プロパティにマップできます。
スキーマ定義でこれらのラベルを使用して、Microsoft 365 Copilot エクスペリエンスでのユーザー データの検出可能性と統合を向上させます。 新しいラベルには、 personEmails、 personAddresses、 personAnniversaries、 personName、 personNote、 personPhones、 personCurrentPosition、 personWebAccounts、 personWebSite、 personSkills、 personProjects、 personAccount、 personAwards、 personCertifications、 personAssistants、 personColleagues、 personManager、 personAlternateContacts、 personEmergencyContactsが含まれます。
Files
SharePoint Embedded ファイル ストレージ コンテナー管理に関連する次の委任されたアクセス許可に対する管理者の同意要件を更新しました。
- 委任されたアクセス許可
FileStorageContainerType.Manage.All管理者の同意が不要になった。 - 委任されたアクセス許可
FileStorageContainerTypeReg.Manage.All管理者の同意が不要になった。
グループ
- resourceBehaviorOptions プロパティと resourceProvisioningOptions プロパティをグループ リソースに追加しました。 これらのプロパティを使用すると、Microsoft 365 グループのグループ動作と関連リソースを指定できます。
- 既知の問題を追加しました:論理的に削除されたセキュリティ グループの場合、securityEnabled プロパティは
trueではなくfalseを返します。 グループの種類を識別するには、 groupTypes プロパティを使用します。ここで、["Unified"]は Microsoft 365 グループを示し、空の配列 ([]) はセキュリティ グループを示します。 詳細については、「 削除済みアイテムを取得する 」と「 削除済みアイテムを一覧表示する」を参照してください。
デバイスとアプリの管理 | クラウド PC
cloudpcexternalpartner の新しいアクションとして configureAgent を追加しました。
cloudpcexternalpartner の新しいアクションとして deployAgent を追加しました。
cloudpcexternalpartner の新しいアクションとして retrieveDeployAgentActionResults を追加しました。
cloudpcexternalpartner の新しいアクションとして retrieveActionReports を追加しました。
cloudpcExternalPartnerAgentSetting を cloudpcexternalpartner の新しい複合型として追加しました。
cloudpcexternalPartner の新しい複合型として cloudPcExternalPartnerActionResult を追加しました。
cloudpcExternalPartnerActionReport を cloudpcexternalpartner の新しい複合型として追加しました。
ID とアクセス | ID とサインイン
- Microsoft Entra IDの QR コード認証方法を使用すると、ユーザーの QR コード認証方法と、QR コードと PIN を使用してサインインする方法を管理できます。 この機能をサポートする主要なリソースは次のとおりです。
- ユーザーの QR コード PIN 認証方法を管理するための qrCodePinAuthenticationMethod リソースと関連 API。 この単一要素認証方法は、現場担当者向けに設計されており、QR コードと PIN を組み合わせています。 次の関連リソースも追加されました: qrCode、 qrPin、 qrCodeImageDetails。
- テナントの QR コード認証方法ポリシーを管理するための qrCodePinAuthenticationMethodConfiguration リソース。
-
authenticationMethodModes および baseAuthenticationMethod 列挙体を更新し、この新しい認証方法をサポートする
qrCodePinメンバーを追加しました。
メール |メッセージ トレース
メッセージ トレース API を使用して、Exchange Online organizationを介した電子メール メッセージのフローを追跡します。 詳細については、「 exchangeMessageTrace」を参照してください。
検索
- 外部接続のユーザー関連プロパティ項目のデータ型を指定するために、 principal データ型と principalCollection データ型を externalConnection に追加しました。
- 外部接続 のスキーマ プロパティに説明を追加できるように、 description プロパティを externalConnection プロパティに追加しました。
- 外部接続スキーマの externalConnection プロパティのラベルに追加できるタグまたはセマンティック ラベルを追加しました。 ラベルはMicrosoft 365 Copilot接続内のデータのセマンティクスを理解し、より関連性の高い結果を提供するのに役立ちます。
- externalConnection に contentCategory プロパティを追加し、関連性とランク付けを向上させるために、外部接続に関連付けられているコンテンツのドメイン カテゴリを指定しました。
セキュリティ |データのセキュリティとコンプライアンス
-
usageRights 列挙型に
labelNotFoundExceptionメンバーを追加しました。 このメンバーは、保護設定のないラベルを表しているため、Microsoft Purview で評価する使用権限はありません。 - microsoft Purview のデータ損失防止ポリシーでの Web 接地アクションの制限をサポートするために、dlpAction 列挙に
restrictWebGroundingメンバーを追加しました。
セキュリティ |脅威の保護
脅威の送信に関連する次の委任されたアクセス許可の管理者の同意要件を更新しました。
- 委任されたアクセス許可
ThreatSubmission.Read管理者の同意が必要になりました。 - 委任されたアクセス許可
ThreatSubmission.ReadWrite管理者の同意が必要になりました。
チームワークとコミュニケーション |管理
- Teams 管理内の特定のポリシー名とポリシーの種類のポリシー ID を取得します。
- ユーザー ID、ポリシーの種類、ポリシー ID を使用して、Teams ポリシーをユーザーに割り当てます。
- ユーザー ID とポリシーの種類を使用して、ユーザーから Teams ポリシーの割り当てを解除します。
- Teams の電話番号をユーザー アカウントに割り当てます 。
- ユーザー アカウントから Teams 電話番号の割り当てを解除します。
- 1 つのテレホン番号の割り当ての詳細を取得します。
- 既存の Teams 電話番号を 省略可能な属性で更新します。
- ユーザー アカウントの割り当てまたは割り当て解除操作の電話番号の状態を確認します。
- ユーザー アカウントに割り当てられた Teams 電話番号の一覧を取得します。
2026 年 2 月: プレビューのみ新規
アプリケーション
agentIdentityBlueprint で requiredResourceAccess プロパティを使用して、エージェントに必要な Microsoft Graph のアクセス許可 (委任されたスコープとアプリ ロール) を指定します。
バックアップ ストレージ
ユーザーは、 fastRestore エンドポイントを参照し、参照セッションを作成してファイルとフォルダーを選択的に復元できるようになりました。
きめ細かい復元プロセスは、シンプルかつ効率的に設計されており、3 つの主要な手順で構成されます。
参照セッションを作成する
特定の復元ポイント (バックアップ スナップショット) の参照セッションを開始します。アイテムを参照する
セッションが作成されると、ユーザーはそれを照会して、参照セッション内で使用可能なすべてのバックアップ済みアイテムを一覧表示できます。- 結果は、それぞれファイル、フォルダー、またはその他のリソースを表す browseQueryResponseItem オブジェクトのコレクションとして返されます。
- SharePoint 参照セッションまたはOneDrive for Business参照セッション内でアイテムを参照できます。
復元セッションを作成する
参照セッションから 1 つ以上の項目を選択し、復元セッションを開始します。- 選択した項目のみが以前の状態に復元され、サイトまたはドライブの残りの部分は変更されません。
- SharePoint の詳細な復元セッションまたはOneDrive for Business詳細な復元セッションを作成できます。
バックアップ ストレージでの保護ポリシーのオフボード状態とタイムスタンプ追跡のサポートを追加しました。
- offboardRequestedDateTime プロパティを protectionPolicyBase リソースに追加しました。
-
protectionPolicyStatus 列挙に
offboardRequested値とoffboarded値を追加しました。
デバイスとアプリの管理 |クラウド ライセンス
新しいクラウド ライセンス API を使用して、Microsoft 365 サービスのテナント、ユーザー、グループのライセンス データを管理します。 これらの API は、割り当て、割り当て、割り当てエラー、サブスクリプション ライフサイクル、待機メンバーへのプログラムによるアクセスを提供します。 詳細については、「 Microsoft Graph でクラウド ライセンス API を使用する (プレビュー)」を参照してください。
Files
driveItem: archive と driveItem: unarchive を追加し、組織が driveItem オブジェクトをアーカイブおよびアーカイブ解除できるようにします。
ID とアクセス | ID とサインイン
- agentIdentityType 列挙を追加して、リスク検出と管理のためのエージェント ID の種類Microsoft Entra表しました。 riskyAgent リソースと agentRiskDetection リソースの identityType プロパティを使用して、さまざまな種類のエージェント ID を分類します。
- レガシ認証システムからの Just-In-Time (JIT) ユーザー移行シナリオをサポートする新しい認証イベント リソースを追加しました。
- onPasswordSubmitListener リソースを使用して、パスワードの送信中にトリガーされる認証イベント リスナーを構成します。
- onPasswordSubmitCustomExtension リソースを使用して、外部レガシ認証システムに対してパスワードを検証するカスタム拡張機能を構成します。
- パスワード送信イベント中に呼び出されるハンドラーの基本型として onPasswordSubmitHandler リソースを使用します。
- onPasswordMigrationCustomExtensionHandler リソースを使用して、JIT 移行中にカスタム拡張機能を呼び出すハンドラーを構成します。
検索
外部接続のユーザー関連のプロパティ項目のデータ型を指定するために、 principal および principalCollection データ型を externalConnection リソースに追加しました。
セキュリティ |データのセキュリティとコンプライアンス
-
usageRights 列挙型に
labelNotFoundExceptionメンバーを追加しました。 このメンバーは、保護設定のないラベルを表しているため、Microsoft Purview で評価する使用権限はありません。 - accessedResources_v2 プロパティを優先して、processConversationMetadata の accessedResources プロパティを非推奨にしました。
- processConversationMetadata の accessedResources_v2 プロパティを使用して、識別子、アクセスの種類、状態など、会話中にアクセスされたリソースに関する詳細情報を取得します。
- メッセージの準備に参加した AI エージェントに関する情報を取得するには、processConversationMetadata の agents プロパティを使用します。
セキュリティ |Emailとコラボレーションの保護
Office 365のMicrosoft Defenderの電子メール内の不審なファイルと URL の分析からの詳細を表す detonationDetails リソースの機能強化:
- より詳細な脅威分析を提供するために、次のプロパティを追加しました。
- detonationBehaviourDetailsV2 - 爆発中に発生したイベントを JSON 形式で表示します
- entityMetadata - JSON 形式のエンティティに関するその他のメタデータ
- mitreTechniques - MITRE ATT&CK フレームワークに合わせた攻撃手法
- staticAnalysis - ファイルまたは URL に対して実行された静的分析の結果
- submissionSource - 申請のソース
- detonationBehaviourDetails プロパティは非推奨となり、2026 年 3 月にデータの返しを停止します。 代わりに detonationBehaviourDetailsV2 プロパティを 使用します。
-
moveToQuarantineメンバーを remediationAction 列挙体に追加しました。 この進化可能な列挙型メンバーにアクセスするには、Prefer: include-unknown-enum-members要求ヘッダーを使用します。
Microsoft Graph に投稿する
Microsoft Graph でのサポートを希望するシナリオがある場合は、
Microsoft Graph フィードバック ポータルを使用して、新機能の提案と投票を行います。 新機能の中には、開発者コミュニティでの要望が高かったことがきっかけとなり開発されたものがあります。 Microsoft Graph チームは、顧客のニーズを定期的に評価し、ベータ (
https://graph.microsoft.com/beta) および v1.0 (https://graph.microsoft.com/v1.0) エンドポイントに新機能をリリースします。毎週の Microsoft 365 プラットフォーム コミュニティコールに参加し、Microsoft Graph コミュニティのアクティブなメンバーになります。 開発者の呼び出しの完全な予定表を確認するには、 Microsoft 365 および Power Platform コミュニティ ページを参照してください。
研究パネルに参加して、開発者エクスペリエンスに関するご意見をお知わせください。