次の方法で共有

Microsoft Graph の新機能

Microsoft Graph には、Microsoft 365、Windows、Enterprise Mobility + Securityのデータにアクセスするために使用できる統合プログラミング モデルが用意されています。 この記事では、Microsoft Graph API、ドキュメント、SDK などの新機能について説明します。

API レベルの更新プログラムの詳細については、Microsoft Graph API変更ログを参照してください。

Microsoft Graph の以前の更新プログラムの詳細については、「 Microsoft Graph の新しい履歴」を参照してください。

重要

プレビュー状態の機能は予告なく変更される可能性があり、一般公開 (GA) 状態に昇格されない場合があります。 運用アプリではプレビュー機能を使用しないでください。

2026 年 2 月: 新規および一般公開

グループ

  • resourceBehaviorOptions プロパティと resourceProvisioningOptions プロパティをグループ リソースに追加しました。 これらのプロパティを使用すると、Microsoft 365 グループのグループ動作と関連リソースを指定できます。
  • 既知の問題を追加しました:論理的に削除されたセキュリティ グループの場合、securityEnabled プロパティはtrueではなくfalseを返します。 グループの種類を識別するには、 groupTypes プロパティを使用します。ここで、 ["Unified"] は Microsoft 365 グループを示し、空の配列 ([]) はセキュリティ グループを示します。 詳細については、「 削除済みアイテムを取得する 」と「 削除済みアイテムを一覧表示する」を参照してください。

ID とアクセス | ID とサインイン

  • Microsoft Entra IDの QR コード認証方法を使用すると、ユーザーの QR コード認証方法と、QR コードと PIN を使用してサインインする方法を管理できます。 この機能をサポートする主要なリソースは次のとおりです。

メッセージの追跡

メッセージ トレース API を使用して、Exchange Online organizationを介した電子メール メッセージのフローを追跡します。 詳細については、「 exchangeMessageTrace」を参照してください。

チームワークとコミュニケーション |管理

  • Teams 管理内の特定のポリシー名とポリシーの種類のポリシー ID を取得します。
  • ユーザー ID、ポリシーの種類、ポリシー ID を使用して、Teams ポリシーをユーザーに割り当てます。
  • ユーザー ID とポリシーの種類を使用して、ユーザーから Teams ポリシーの割り当てを解除します。

2026 年 2 月: プレビューのみ新規

アプリケーション

agentIdentityBlueprint で requiredResourceAccess プロパティを使用して、エージェントに必要な Microsoft Graph のアクセス許可 (委任されたスコープとアプリ ロール) を指定します。

バックアップ ストレージ

ユーザーは、 fastRestore エンドポイントを参照し、参照セッションを作成してファイルとフォルダーを選択的に復元できるようになりました。

きめ細かい復元プロセスは、シンプルかつ効率的に設計されており、3 つの主要な手順で構成されます。

デバイスとアプリの管理 |クラウド ライセンス

新しいクラウド ライセンス API を使用して、Microsoft 365 サービスのテナント、ユーザー、グループのライセンス データを管理します。 これらの API は、割り当て、割り当て、割り当てエラー、サブスクリプション ライフサイクル、待機メンバーへのプログラムによるアクセスを提供します。 詳細については、「 Microsoft Graph でクラウド ライセンス API を使用する (プレビュー)」を参照してください。

Files

ID とアクセス | ID とサインイン

  • agentIdentityType 列挙を追加して、リスク検出と管理のためのエージェント ID の種類Microsoft Entra表しました。 riskyAgent リソースと agentRiskDetection リソースの identityType プロパティを使用して、さまざまな種類のエージェント ID を分類します。
  • レガシ認証システムからの Just-In-Time (JIT) ユーザー移行シナリオをサポートする新しい認証イベント リソースを追加しました。
    • onPasswordSubmitListener リソースを使用して、パスワードの送信中にトリガーされる認証イベント リスナーを構成します。
    • onPasswordSubmitCustomExtension リソースを使用して、外部レガシ認証システムに対してパスワードを検証するカスタム拡張機能を構成します。
    • パスワード送信イベント中に呼び出されるハンドラーの基本型として onPasswordSubmitHandler リソースを使用します。
    • onPasswordMigrationCustomExtensionHandler リソースを使用して、JIT 移行中にカスタム拡張機能を呼び出すハンドラーを構成します。

セキュリティ |データのセキュリティとコンプライアンス

  • 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 要求ヘッダーを使用します。

ExternalConnection に Principal データ型と PrincipalCollection データ型を追加し、外部接続のデータ型 people プロパティ関連項目として指定しました。

2026 年 1 月: 新規および一般公開

ID とアクセス | ID とサインイン

レポート | Microsoft 365 の使用状況レポート

今後は、/copilot URL パス セグメントのMicrosoft 365 Copilot使用状況 API を使用します。 詳細については、以下を参照してください:

セキュリティ |高度なハンティング

Microsoft Defender for Endpoint (MDE) の高度なハンティング API の移行ガイダンスを追加しました。これにより、組織は、https://api.securitycenter.microsoft.com エンドポイントを通じて利用できる廃止された API から Microsoft Graph で利用可能な高度なハンティング API に移行できます。 詳細については、「 古い API からの移行」を参照してください。

セキュリティ |アラートとインシデント

  • インシデント リソースに priorityScore プロパティを追加し、 インシデント の優先度スコアを 0 から 100 に設定し、 > 85 が最優先事項、15 から 85 の中優先度、 < 15 の低優先度を提供しました。 このスコアは機械学習を使用して生成され、重大度、中断への影響、脅威インテリジェンス、アラートの種類、資産の重要度、脅威分析、インシデントの希少性、追加の優先度シグナルなど、複数の要因に基づいています。
  • Microsoft Defender for Identity (MDI) センサーを管理するための API を次のように更新しました。
    • センサーのドメイン名を指定するために、sensorCandidate リソースに domainName プロパティを追加しました。
    • サービスの状態を示すために、センサー リソースに serviceStatus プロパティを追加しました。 使用可能な値: stopped、starting、running、disabled、onboarding、unknown、unknownFutureValue。

セキュリティ |証拠 開示

ediscoveryPurgeDataOperation の reportFileMetadata プロパティを使用して、消去ジョブ レポート ファイルのメタデータを取得します。

チームワークとコミュニケーション |アプリ

TeamsAppInstallation.ManageSelectedForTeam.Allは、チームで teamsAppInstallation を使用する場合にリソース固有の同意 (RSC) アクセス許可に同意する必要がある Teams アプリのインストールまたはアップグレードに必要な最小限の特権アプリケーションアクセス許可です。アップグレード API。

2026 年 1 月: プレビューのみ新規

アプリケーション

allowedTenantsAudience の allowedTenantIds プロパティには、少なくとも 1 つの値を含める必要があり、20 を超える値を含めることはできません。

デバイスとアプリの管理 | クラウド PC

  • 次のリソースを使用して、カタログ内のカスタム拡張機能を使用するときにカスタム拡張機能の吹き出し要求の一部として、Azure Logic Apps に送信されるデータを表します。
  • organization全体のパッケージへのライフサイクルとアクセスを制御するポリシーを表すために、controlConfiguration リソースと controlConfigurations リレーションシップを entitlementManagement リソースに追加しました。
  • Microsoft Entra ID Protection によって検出された危険なユーザーの承認構成を表す entraIdProtectionRiskyUserApproval リソースを追加しました。
  • Microsoft Purview インサイダー リスク管理によって検出された危険なユーザーの承認構成を表す insiderRiskyUserApproval リソースを追加しました。

ID とアクセス | ID とサインイン

microsoftRevokedSessions値を riskDetail 列挙に追加して、Microsoft がセッションを取り消したことを示しました。 この列挙メンバーは、identity Protection リソースである riskDetection、riskUserActivity、riskyUser、signIn のMicrosoft Entraに適用されます。

デバイスとアプリの管理 |デバイスの更新

自動パッチ管理環境での Windows 品質更新プログラムの新しい承認と展開管理モデルを追加しました。 カスタマイズ可能な承認ルールを使用して品質更新ポリシーを定義し、段階的なロールアウトのために展開リングをグループ デバイスに割り当て、デバイスに展開する前に更新コンテンツの承認状態を管理できるようになりました。 詳細については、次のリソースを参照してください。

グループ

グループ リソースの welcomeMessageEnabled プロパティを使用して、新しいメンバーが Microsoft 365 グループに追加されたときにウェルカム メッセージを送信するかどうかを制御します。 既定値は true です。

ID とアクセス | ID とサインイン

  • riskRemediationを新しいメンバーとして conditionalAccessGrantControl 列挙型に追加しました。 この値を使用すると、ユーザーは条件付きアクセス ポリシーを使用してユーザー リスクを自己修復できます。
  • クロステナント アクセス ポリシー設定でパートナー テナントからグループを同期できるかどうかを定義するには、crossTenantIdentitySyncPolicyPartner の groupSyncInbound プロパティを使用します。

メッセージの追跡

userConfiguration リソースとそれに関連付けられているメソッドを使用して、XML、バイナリ、またはディクショナリ形式を使用して、メールボックス フォルダーに関連付けられているユーザー固有の設定、メタデータ、またはアプリケーション データを管理します。

レポート | ID およびアクセス レポート

conditionalAccessAudience リソースの種類を削除しました。 signIn リソース型の conditionalAccessAudiences プロパティの戻り値の型は、conditionalAccessAudience 複合型ではなく String オブジェクトのコレクションです。 メッセージ トレース API を使用して、Exchange Online organizationを介した電子メール メッセージのフローを追跡します。 詳細については、「 exchangeMessageTrace」を参照してください。

レポート | ID およびアクセス レポート

credentialUsageSummary、userCredentialUsageDetails、userEventsSummary、userRegistrationActivitySummary リソースの authMethod プロパティの型である usageAuthMethod 列挙の新しいサポートされる値として、qrCodeを追加しました。 この値は、認証方法としての QR コード の使用を表します。

セキュリティ |アラートとインシデント

インシデント リソースに priorityScore プロパティを追加し、 インシデント の優先度スコアを 0 から 100 に設定し、 > 85 が最優先事項、15 から 85 の中優先度、 < 15 の低優先度を提供しました。 このスコアは機械学習を使用して生成され、重大度、中断への影響、脅威インテリジェンス、アラートの種類、資産の重要度、脅威分析、インシデントの希少性、追加の優先度シグナルなど、複数の要因に基づいています。

セキュリティ |クラウド ゾーン

Microsoft Defender for Cloud のゾーン管理のサポートを追加しました。これにより、組織はマルチクラウド環境 (Azure、AWS、GCP、DevOps またはレジストリ ソース) を、大規模なアクセスとセキュリティ管理のための論理グループにセグメント化できるようになりました。 ゾーン リソースの種類とそれに関連付けられている環境リソースを使用すると、最小特権のアクセス制御を一貫して適用し、Microsoft Graph 内のアタッチされた環境のコレクションを管理できます。

セキュリティ |データのセキュリティとコンプライアンス

  • accessedResources_v2 プロパティを優先して、processConversationMetadata の accessedResources プロパティを非推奨にしました。
  • processConversationMetadata の accessedResources_v2 プロパティを使用して、識別子、アクセスの種類、状態など、会話中にアクセスされたリソースに関する詳細情報を取得します。
  • メッセージの準備に参加した AI エージェントに関する情報を取得するには、processConversationMetadata の agents プロパティを使用します。
  • コンテンツが AI で生成されているかどうかを示すために、processConversationMetadata と processFileMetadata に contentCategory プロパティを追加しました。

チームワークとコミュニケーション |アプリ

チャネル リソースの layoutType プロパティを使用して、会話エクスペリエンスが異なるチャネルを作成し、いつでも切り替えることができます。 プロパティは、従来の応答後形式の post と、チャットのようなスレッド エクスペリエンスの chat の 2 つの値をサポートしています。 チャネルの作成時にレイアウトの種類 を 設定し、後 で更新して レイアウトを切り替えることができます。 TeamsAppInstallation.ManageSelectedForTeam.Allは、チームで teamsAppInstallation を使用する場合にリソース固有の同意 (RSC) アクセス許可に同意する必要がある Teams アプリのインストールまたはアップグレードに必要な最小限の特権アプリケーションアクセス許可です。アップグレード API。

テナント管理 |構成管理

Microsoft Graph の新しい統合テナント構成管理 API を使用すると、管理者は、organization内の 1 つのワークロードまたは複数のワークロードにわたって構成設定を制御および管理できます。 サポートされているユース ケースの詳細については、「 Microsoft Graph での統合テナント構成管理 API の使用 (プレビュー)」を参照してください。

2025 年 12 月: 新規および一般公開

予定表 |Places

  • 場所とその派生オブジェクト (建物、デスク、フロア、セクションなど) を作成、取得、削除します。 これらの API を使用すると、Places ディレクトリのスケーラブルなオンボードと管理が可能になります。
  • Placesの新しいマップ API を使用すると、適切な読み取りまたは書き込みアクセス許可を持つアプリケーションがマップ フィーチャ オブジェクトと対話できるようになります。 詳細については、「Microsoft Graph でのPlaces API の操作」を参照してください。
  • checkInClaim リソースを使用して、場所で予約された Outlook 予定表イベントのチェック状態を表します。 詳細については、「 checkInClaim の作成 」と「 Get checkInClaim」を参照してください。
  • 建物に Wi-Fi があるかどうかを示すには、 建物 の wifiState プロパティを使用します。
  • デスクの heightAdjustableState プロパティを使用して、 デスク の高さが調整可能かどうかを示します。
  • 会議室で teamsEnabledState プロパティを使用して、 ルーム がMicrosoft Teamsに対して有効になっているかどうかを示します。
  • 部屋とワークスペースの placeId プロパティを、変更できない一意の別の識別子として使用します。
  • unavailablePlaceMode リソースを使用して、デスクまたはワークスペースが予約不可としてマークされている理由を示します。

チームワークとコミュニケーション |管理

Teams コンテキストでアカウントを持つユーザーのユーザー構成を取得または一覧表示します。

チームワークとコミュニケーション |通話とオンライン会議

  • teams 会議に適用される秘密度ラベルを指定するには、onlineMeeting および virtualEventSession で sensitivityLabelAssignment プロパティを使用します。
  • onlineMeeting および virtualEventSession で expiryDateTime プロパティを使用して、会議リソースの有効期限が切れる日時を示します。
  • onlineMeeting および virtualEventSession の meetingSpokenLanguageTag プロパティを使用して、会議中に記録と文字起こしのために使用される音声言語を指定します。
  • 指定した会議の Teams 会議オプション ページの URL を取得するには、onlineMeeting および virtualEventSession で meetingOptionsWebUrl プロパティを使用します。

チームワークとコミュニケーション |メッセージング

$expand=membersが含まれている場合、List chats API は、より大きな$top値を指定した場合でも、最大 25 個の項目を返します。

2025 年 12 月: プレビューのみ新規

予定表 |Places

1 つ以上の place オブジェクトを非同期モードでアップサートします。

セキュリティ

セキュリティ アラートでの mailboxConfigurationEvidence と activeDirectoryDomainEvidence の証拠の種類のサポートを追加しました

2025 年 11 月: プレビューのみ新規

workHoursAndLocationsSetting、workPlanOccurrence、workPlanRecurrence の各リソースを使用して、柔軟な勤務時間と場所を管理します。 これらのリソースを使用すると、最新のハイブリッド シナリオの定期的な作業パターンと特定の作業パターン、場所、休暇を定義できます。

チームワークとコミュニケーション |アプリ

次の API を使用して、チーム内のチャネル レベルで Teams アプリを管理します。

2025 年 9 月: 新規および一般公開

アプリケーション

アプリケーション リソースのsignInAudienceRestrictions プロパティを使用して、マルチテナント アプリケーションを特定のMicrosoft Entra テナントに制限します。 この機能を使用すると、組織はアプリケーションの使用を許可されたテナント ID の特定のリストに制限し、マルチテナント シナリオのセキュリティとコンプライアンスの制御を強化できます。

デバイスとアプリの管理 |クラウド印刷

printerCapabilities リソースの mediaSizes プロパティで、サポートされている新しいメディア サイズを使用します。

Files

  • Microsoft Graph の SharePoint クロステナント移行タスク API を使用して、組織がテナント間の移行中にタスクを管理できるようにします。 詳細については、「 sharePointMigrationTask」を参照してください。
  • sharePointGroupIdentityMapping と sharePointUserIdentityMapping で削除されたプロパティを使用して、ID マッピングが正常に削除されたことを示します。

ID とアクセス | 社内

  • 次のリソースを使用して、カタログ内のカスタム拡張機能を使用するときにカスタム拡張機能の吹き出し要求の一部として、Azure Logic Apps に送信されるデータを表します。
  • organization全体のパッケージへのライフサイクルとアクセスを制御するポリシーを表すために、controlConfiguration リソースと controlConfigurations リレーションシップを entitlementManagement リソースに追加しました。
  • Microsoft Entra ID Protection によって検出された危険なユーザーの承認構成を表す entraIdProtectionRiskyUserApproval リソースを追加しました。
  • Microsoft Purview インサイダー リスク管理によって検出された危険なユーザーの承認構成を表す insiderRiskyUserApproval リソースを追加しました。

ID とアクセス | ID とサインイン

microsoftRevokedSessions値を riskDetail 列挙に追加して、Microsoft がセッションを取り消したことを示しました。 この列挙メンバーは、identity Protection リソースである riskDetection、riskUserActivity、riskyUser、signIn のMicrosoft Entraに適用されます。

ID とアクセス |ネットワーク アクセス

グローバル セキュリティで保護されたアクセスが Web リソースへのアクセスをブロックするときにユーザーに表示されるブロック ページ メッセージをカスタマイズします。 customBlockPage リソースを使用して、マークダウンのサポートが制限されたカスタム メッセージを構成します。

メール

  • userConfiguration リソースとそれに関連付けられているメソッドを使用して、XML、バイナリ、またはディクショナリ形式を使用して、メールボックス フォルダーに関連付けられているユーザー固有の設定、メタデータ、またはアプリケーション データを管理します。
  • callRecord: getPstnCalls API は、Telstra 呼び出しプランのみの情報を返さないことを明確にしました。
  • 次のエンドポイントは、 ユーザーの作業場所を管理するためにサポートされなくなりました。
    • POST /users/{usersId}/presence/clearAutomaticLocation
    • POST /communications/presences/{presenceId}/clearAutomaticLocation
    • POST /users/{usersId}/presence/clearLocation
    • POST /communications/presences/{presenceId}/clearLocation
    • POST /users/{usersId}/presence/setAutomaticLocation
    • POST /communications/presences/{presenceId}/setAutomaticLocation
    • POST /users/{usersId}/presence/setManualLocation
    • POST /communications/presences/{presenceId}/setManualLocation

レポート | ID およびアクセス レポート

  • conditionalAccessAudience リソースの種類を削除しました。 signIn リソース型の conditionalAccessAudiences プロパティの戻り値の型は、conditionalAccessAudience 複合型ではなく String オブジェクトのコレクションです。

チームワークとコミュニケーション |通話とオンライン会議

  • $expand=membersが含まれている場合、List chats API は、より大きな$top値を指定した場合でも、最大 25 個の項目を返します。
  • 次のエンドポイントは、ユーザーの 作業場所 を管理するためにサポートされなくなりました。
    • POST /users/{usersId}/presence/clearAutomaticLocation
    • POST /communications/presences/{presenceId}/clearAutomaticLocation
    • POST /users/{usersId}/presence/clearLocation
    • POST /communications/presences/{presenceId}/clearLocation
    • POST /users/{usersId}/presence/setAutomaticLocation
    • POST /communications/presences/{presenceId}/setAutomaticLocation
    • POST /users/{usersId}/presence/setManualLocation
    • POST /communications/presences/{presenceId}/setManualLocation

チームワークとコミュニケーション |メッセージング

  • 共有チャネルの 間接メンバーシップ変更通知 を受け取るチャネル メンバーシップ サブスクリプションのサポートを追加しました。
  • チャネルがチームと共有または共有解除されたときに、共有チャネル メンバーシップの新しい変更通知が導入されました。
  • チャネル allMembers コレクションから特定のメンバーを取得します。 この API は、共有チャネルを含むすべてのチャネルの種類にわたって、直接メンバーと間接メンバーの両方に統合アクセスを提供します。
  • 既存のチャネルで移行モードを有効にして、外部メッセージの移行を開始します。
  • 既存のチャットで移行モードを有効にして、外部メッセージの移行を開始します。
  • チャットから移行モードを削除して、外部メッセージの移行を完了します。
  • チャネル リソースの layoutType プロパティを使用して、会話エクスペリエンスが異なるチャネルを作成し、いつでも切り替えることができます。 プロパティは、従来の応答後形式の post と、チャットのようなスレッド エクスペリエンスの chat の 2 つの値をサポートしています。 チャネルの作成時にレイアウトの種類 を 設定し、後 で更新して レイアウトを切り替えることができます。

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 コミュニティ ページを参照してください。

  • 研究パネルに参加して、開発者エクスペリエンスに関するご意見をお知わせください。

関連コンテンツ

  • Last updated on