Microsoft Graph の新機能

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

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

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

2026 年 10 月: 新機能および一般提供

予定表

• 予定表リソースの isSharedWithMe プロパティをベータ版から v1.0 に昇格しました。 このプロパティは、共有予定表を識別するために使用されます。
• 予定表リソースの種類にデルタ メソッドを追加しました。 これを使用して、ユーザーのメールボックスで追加、削除、または更新された予定表を追跡します。

メール |メッセージの追跡

メッセージ追跡で取り消されたメッセージを識別するためのサポートが追加されました。 exchangeMessageTrace リソースの status プロパティでサポートされている値として、recalled を使用します。

2026 年 10 月: プレビューのみの新機能

バックアップと回復 |Microsoft 365 のバックアップとストレージ

• activityLogBase リソースとその派生型を使用して、ポリシーの変更、動的なルールの実行、オフボード、復元タスクの完了など、バックアップおよび復元リソースに関する管理アクティビティを追跡します。
• restoreTaskActivityLog の tags プロパティを削除し、restoreJobType プロパティを優先しました。 restoreJobType 列挙型の値と共に restoreJobType プロパティを使用します。
• backupPolicyDeleted メンバーを、activityLogBase リソースとその派生型の activityType プロパティの新しいサポート値として追加しました。

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

cloudPcDeviceImage、cloudPcSourceDeviceImage、cloudPcGalleryImage の非推奨の画像プロパティが 2024 年 1 月 31 日から 2026 年 12 月 7 日までデータの返しを停止する日付を更新しました。 recommendedSku の置換は計画されていません。 これらのリソース トピックの置換プロパティ ガイダンスを確認し、期限前に影響を受ける統合を更新します。

Files

SharePoint サービスの優先順位付けレポートをサポートするように、 getSharePointApiUsage メソッドを更新しました。 このレポートを使用して、アプリケーションおよび日付別の合計、標準、ヘビー、請求済み標準、および請求済みヘビー API 要求カウントを取得します。

ID とアクセス | 社内

• アクセス パッケージの意図とは異なる管理対象リソースを識別するための accessDriftSummary リソースの種類と関連メソッドを追加しました。 これを使用して、ドリフト サマリーの一覧表示と検査、ドリフトの詳細の取得、一括調整レポートのダウンロードを行います。 アクセス ドリフトの詳細は、entraDriftIdentityInfo の identityType プロパティを通じて、影響を受ける各 ID がユーザーかグループかを識別します。

メール |メッセージの追跡

メッセージ追跡で取り消されたメッセージを識別するためのサポートが追加されました。 exchangeMessageTrace リソースの status プロパティでサポートされている値として、recalled を使用します。

メールボックスのインポートとエクスポート

• 非表示のメールボックス フォルダーを識別するために、mailboxFolder リソースに isHidden プロパティを追加しました。
• フォルダーの一覧表示と子フォルダーの一覧表示には、既存の includeHiddenFolders クエリ パラメーターを使用します。 非表示フォルダーと非表示フォルダーの両方を含めるには、[ true ] に設定します。

セキュリティ

detectionAction リソースと incidentConfiguration 複合型に incidentConfiguration プロパティを追加しました。 この設定を使用して、カスタム検出ルールによって生成されたアラートを自動インシデント相関から除外し、スタンドアロンの単一アラート インシデントを作成します。

セキュリティ |監査ログのクエリ

auditLogRecordType 列挙型に PlannerCustomFieldDefinition から MESRawEmailContentMetadata までの 35 個のメンバーを追加し、ワークロード固有の監査イベント ペイロードを表すために一致する auditData 派生型を追加しました。

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

不完全なポリシー評価に対して顧客向け理由を使用するように evaluationErrorType 列挙型を更新し、evaluationErrorDetail 複合型から errorMessage プロパティを削除しました。 errorType を使用して、評価を完了できなかった理由を特定します。

セキュリティ |ブック

• テナント スコープの Microsoft セキュリティ ブック ドキュメントを管理するための ブック リソースの種類と関連するメソッドを追加しました。 反復可能なデプロイには安定した ID を使用し、ブックの JSON コンテンツを完全なドキュメントとして置き換えます。

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

表示名 (displayName)、サービス発行識別子 (reactionId)、またはその両方を指定して、チャット メッセージのカスタム絵文字リアクションを設定および設定解除するためのサポートが追加されました。 詳細については、「 chatMessageReaction」を参照してください。

2026 年 9 月: 新機能および一般提供

予定表 |作業時間と場所

workHoursAndLocationsSetting、 workPlanOccurrence、および workPlanRecurrence リソースと関連メソッドにアプリのみのサポートを追加しました。 アプリは、 Calendars.Read.All アプリケーションのアクセス許可を使用して、ユーザーの設定、繰り返し、および発生を読み取り、それらを Calendars.ReadWrite.All して、それらを作成、更新、および削除できます。

変更通知

changeType 列挙型のunknownFutureValueメンバーをベータ版から v1.0 に昇格しました。 この列挙型は、通知変更の種類を特定するために、 changeNotification リソースと commsNotification リソースによって使用されます。

Files

• isPatternToken プロパティを fileStorageContainerCustomPropertyValue リソースに追加して、カスタム プロパティ値が、リテラル値ではなく、コンシューマーが使用前に解決する必要があるurlTemplateパターンであるかどうかを示します。
• isOfficeRestricted プロパティを fileStorageContainerTypeSettings リソースと fileStorageContainerTypeRegistrationSettings リソースに追加し、fileStorageContainerTypeSettingsOverride 列挙型を追加しました。
• アクセス許可リソースの revokeGrants メソッドを使用して、指定された受信者の共有リンクへのアクセスを取り消します。

グループ

グループ リソースに onPremisesExtensionAttributes プロパティを追加しました。 これを使用して、オンプレミスの Active Directory から同期された拡張機能属性 1 から 15 にアクセスします。

ID とアクセス | ディレクトリの管理

• directoryRoleManagementDeletedItemContainer リソースの種類と関連するメソッドを v1.0 に追加しました。 これらの API を使用して、論理的に削除されたカスタム ロールを一覧表示して検査したり、アクティブなロール定義コレクションに復元したり、完全に削除したりできます。
• v1.0 のデバイス リソースにプロビジョニング操作を追加して、承認された仮想デスクトップ インフラストラクチャ (VDI) プロバイダーが顧客のディレクトリ内のデバイスをプロビジョニングできるようにします。 v1.0 のデバイス リソースにプロビジョニング操作を追加して、承認された仮想デスクトップ インフラストラクチャ (VDI) プロバイダーが顧客のディレクトリ内のデバイスをプロビジョニングできるようにします。

ID とアクセス | 社内

• アクセス レビューの顧客提供のデータ API をベータ版から v1.0 に昇格しました。 これらを使用して、サード パーティ製アプリケーションなど、Microsoft Entra が自身を検出しないリソースに対してアップロードするエンタイトルメント データを確認します。 昇格されたサーフェスには次のものが含まれます。
  • レビュー中のリソースを記述するための accessReviewInstanceDecisionItemResource の description プロパティ。
  • accessReviewInstanceDecisionItemPermission 複合型と accessReviewInstanceDecisionItem の permission プロパティーは、レビュー中のリソースへのプリンシパル・アクセスを許可するアクセス許可を記述します。
  • accessReviewInstanceDecisionItemCustomDataProvidedResource 複合型は、Microsoft Entra によって検出されるのではなく、顧客からエンタイトルメント データが提供される決定項目リソースを表します。
  • batchApplyCustomDataProvidedResourceDecisions 1 回の呼び出しで顧客提供リソースに一致するすべての決定項目に適用結果を設定します。
  • 記録された決定をターゲット リソースに適用した結果を表す accessReviewInstanceDecisionItemApplyResult 列挙型。
• リソース の一覧 表示メソッドは、委任されたアクセス許可で呼び出された場合にのみ SharePoint Online リソースを返すことを明確にしました。 アプリケーションのアクセス許可で SharePoint サイト情報を取得するには、 sites: getAllSites メソッドを使用します。

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

• 共有デバイスでリソース アカウント キーの資格情報を管理するための resourceAccountKeyAuthenticationMethod リソースの種類と関連するメソッドを追加しました。 API を使用して資格情報を一覧表示、取得、削除し、Teams Rooms や Teams 電話などのデバイスがユーザーの操作なしでサインインできるようにします。
• anonymousCalendarSharingFreeBusyDetail、anonymousCalendarSharingFreeBusyReviewer、および anonymousCalendarSharingFreeBusySimple リソースの種類を追加しました。 これらのクロス テナント アクセス ポリシー機能を使用して、匿名の外部ユーザーがさまざまな詳細レベルで予定表の空き時間情報を表示することを承認します。

セキュリティ |監査ログのクエリ

isRecordCountLimitExceeded、recordCountLimit、および approximateReturnedRecordCount プロパティを auditLogQuery リソースに追加しました。 これらのプロパティを使用して、完了したクエリが検索ごとのレコード数の制限を超えたかどうかを確認し、適用可能な制限とおおよその返されるレコード数を調べます。

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

テナントがプライベート チャネル ストレージの移行を完了した後に編集または削除されたプライベート チャネル メッセージの保持バージョンのエクスポートをサポートするように、 getAllRetainedMessages メソッドを更新しました。

2026 年 9 月: プレビューのみの新機能

Agents

agentIdentityBlueprint リソースに isDisabled プロパティを追加しました。 エージェント ID ブループリントを削除せずに非アクティブ化するには、これを使用します。

アプリケーション

isDeviceAccessEnabled プロパティを onPremisesPublishing リソースに追加して、Microsoft Entra Private Access のデバイス アクセスを構成しました。

バックアップと回復 |Microsoft 365 のバックアップとストレージ

• restoreSessionBase リソースの種類に policyId プロパティを追加して、セッションを保護ポリシーにリストアする範囲を設定しました。
• 省略可能な policyId パラメーターを restorePoint: 検索 メソッドに追加して、保護ユニットのメンバーシップを検証し、ポリシー スコープのルーティングを改善しました。 protectionUnit/policyIdで復元ポイント コレクションをフィルター処理することもできます。

バックアップ ストレージ

• Microsoft 365 バックアップ ストレージのポリシー レベルの保護統計を取得するための getStatisticsByPolicy メソッドを追加しました。 このレポートを使用して、保護されたアーティファクトと保護されていないアーティファクトを完了、進行中、失敗の状態にわたって監視し、オフボード アクティビティを確認し、メトリックが最後に計算された日時を特定します。

Calendar |Places

• カスタム文字列のキーと値のペアを表す stringDictionary リソース型を追加しました。
• 顧客定義の文字列キーと値のペアを格納するために、place リソースの種類に customProperties プロパティを追加しました。
• 場所の最終更新日を示すために、場所リソースの種類に読み取り専用の lastUpdatedTime プロパティを追加しました。

予定表 |作業時間と場所

workHoursAndLocationsSetting、 workPlanOccurrence、および workPlanRecurrence リソースと関連メソッドにアプリのみのサポートを追加しました。 アプリは、 Calendars.Read.All アプリケーションのアクセス許可を使用して、ユーザーの設定、繰り返し、および発生を読み取り、それらを Calendars.ReadWrite.All して、それらを作成、更新、および削除できます。

変更通知

unknownFutureValue メンバーを、上位互換性のある通知変更の種類をサポートするために changeNotification リソースによって使用される changeType 列挙体を追加しました。

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

• isDisasterRecoveryActive プロパティを cloudPC リソースに追加して、フェールオーバー イベント後にクラウド PC が現在ディザスター リカバリー リージョンで実行されているかどうかを示します。
• cloudPC および cloudPcStatusSummary リソースの状態プロパティでサポートされている値として、failoverInProgress と failbackInProgress を使用します。

Files

• ユーザーの Microsoft Entra ID オブジェクト ID を渡すことで、ユーザーが所有するファイル ストレージ コンテナーの一覧を取得するために、fileStorageContainer リソースの getByUser メソッドに userObjectId パラメーターを追加しました。
• isPatternToken プロパティを fileStorageContainerCustomPropertyValue リソースに追加して、カスタム プロパティ値が、リテラル値ではなく、コンシューマーが使用前に解決する必要があるurlTemplateパターンであるかどうかを示します。

ID とアクセス | ディレクトリの管理

• 削除されたカスタム ロール定義を回復するための directoryRoleManagementDeletedItemContainer リソースの種類と関連するメソッドを追加しました。 これらの API を使用して、論理的に削除されたカスタム ロールを一覧表示して検査したり、アクティブなロール定義コレクションに復元したり、完全に削除したりできます。
• 承認された仮想デスクトップ インフラストラクチャ (VDI) プロバイダーが顧客のディレクトリにデバイスをプロビジョニングできるように、デバイス リソースにプロビジョニング操作を追加しました。

グループ

• グループ リソースに disableNesting プロパティを追加しました。 これを使用すると、他のグループがセキュリティ グループのメンバーとして追加されないようにすることができます。

ID とアクセス | ディレクトリの管理

• 承認された仮想デスクトップ インフラストラクチャ (VDI) プロバイダーが顧客のディレクトリにデバイスをプロビジョニングできるように、デバイス リソースにプロビジョニング操作を追加しました。

ID とアクセス | 社内

• Get accessPackageResourceEnvironment メソッドが、委任されたアクセス許可で呼び出された場合にのみ SharePoint Online リソース環境を返すことを明確にしました。 SharePoint Online リソース環境は SharePoint ルート サイトに対応するため、アプリケーションのアクセス許可でルート サイト情報を取得するには、$filter=siteCollection/root ne null クエリ オプションと共に List sites メソッドを使用します。
• エージェント ID とゲスト ユーザーを管理するライフサイクル ポリシーのパブリック プレビュー サポートを追加しました。 lifecyclePolicy とその派生ポリシー タイプを使用して、スコープ、ルール、ワークフローの適用、影響評価、およびレポートの処理を構成します。
• ゲスト ユーザーのライフサイクル アクションを追加して、構成 証明、 サインイン ユーザーをスポンサーとして追加し、 サインイン ユーザーをスポンサーとして削除しました。

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

requireCertificateSidAlignment プロパティを x509CertificateAuthenticationMethodConfiguration リソースに追加しました。 証明書ベースの認証中にハイブリッド ユーザーとクラウド専用ユーザーに証明書 SID のアライメントを要求するために使用します。

ID とアクセス |& の正常性の監視

• Microsoft Entra 推奨事項とその影響を受けるリソースのタグ付けのサポートが追加されました。 recommendation: addTag、recommendation: removeTag、impactedResource: addTag、および impactedResource: removeTag メソッドを使用して、新しい recommendationTag リソースに裏打ちされたタグ関係を管理します。 また、impactedResource: addTag メソッドと impactedResource: removeTag メソッドを使用して、1 回の要求で最大 50 個の影響を受けるリソースのタグを追加または削除することもできます。
• 推奨事項と影響を受けるリソースの代替修復状態を追加しました。 推奨リソースでは markPlanned、acceptRisk、applyAlternateMitigation メソッドを使用し、impactedResource リソースでは対応するメソッドを使用します。
• recommendationStatus 列挙型に needsMoreAction メンバーを追加し、recommendationPriority 列挙型に critical メンバーを追加しました。
• nistClassificationリソースとnistClassificationsプロパティをrecommendationBaseリソースに追加して、推奨事項をNIST Cybersecurity Framework 2.0の機能とカテゴリにマッピングしました。
• categoryGroup プロパティ (および新しい recommendationCategoryGroup 列挙)、completedBySystemDateTime、completedByUserDateTime、failedReviewDateTime、needsMoreActionResourceCount、remediatedDateTime、および statusModifiedDateTime プロパティを recommendationBase リソースに追加しました。 microsoftEntraSuite メンバーを requiredLicenses 列挙型に追加し、lastRefreshedDateTime プロパティを recommendationConfiguration リソースに追加しました。

People and workplace intelligence |分析

searchHit リソースの種類に sensitivityLabel プロパティを追加して、検索結果リソースの秘密度ラベル情報を提供しました。

レポート |パートナー課金レポート

CSP パートナーが特定の請求書に対して請求された集計された Azure 使用状況レポートを生成できるようにするための billedAggregatedUsage リソースの種類と関連するエクスポート メソッドを追加しました。

セキュリティ |監査ログのクエリ

isRecordCountLimitExceeded、recordCountLimit、および approximateReturnedRecordCount プロパティを auditLogQuery リソースに追加しました。 これらのプロパティを使用して、完了したクエリが検索ごとのレコード数の制限を超えたかどうかを確認し、適用可能な制限とおおよその返されるレコード数を調べます。

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

• ユーザーのコンピューティング保護スコープとテナント API のコンピューティング保護スコープで使用される userActivityTypes 列挙型にcontentFilteringメンバーを追加し、コンテンツを評価する前にアプリケーションがデータ損失防止ポリシーによってコンテンツ フィルタリングを管理するかどうかを判断できるようにします。
• 完了できなかったポリシー評価のレポートをサポートするために、 contentActivity リソースを更新しました。 執行平面は、既存のコンテンツ アクティビティの取り込み API を介して、構造化された不完全な検査理由を送信できます。
• policyScopeBase リソースの種類に policyConfiguration プロパティを追加しました。 適用平面では、保護スコープ API によって返される有効な既定のセキュリティ構成を使用して、ポリシーの評価を完了できない場合にコンテンツを監査するかブロックするかを決定できます。

タスクとプラン

Planner Graph V4 の プラン リソースの種類を追加しました。 これらの API を使用して、既存の Planner API サーフェスよりも豊富なスケジューリング、依存関係、カスタム フィールド、チャット機能を備えたプランとタスクを作成および管理します。

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

getAllRetainedMessages メソッドを更新して、テナントのプライベート チャネル ストレージの移行が完了した後にキャプチャされた保持プライベート チャネル メッセージ バージョンのサポートを文書化しました。

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 コミュニティ ページにアクセスしてください。

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

関連コンテンツ

• Microsoft Graph 開発者ブログ。
• Microsoft Graph API 変更ログ。
• Microsoft Graph の新機能の履歴。