Microsoft Graph には、Microsoft 365、Windows、Enterprise Mobility + Security のデータへのアクセスに使用できる統合プログラミング モデルが用意されています。 この記事では、Microsoft Graph API、ドキュメント、SDK などの新機能について説明します。
API レベルの更新の詳細については、「Microsoft Graph API の変更ログ」を参照してください。
Microsoft Graph の以前の更新プログラムの詳細については、「 Microsoft Graph の新機能の履歴」を参照してください。
重要
プレビュー状態の機能は予告なく変更される場合があり、一般提供 (GA) 状態に昇格されない場合があります。 運用アプリではプレビュー機能を使用しないでください。
2026 年 10 月: 新機能および一般提供
メール |メッセージの追跡
- メッセージ追跡で取り消されたメッセージを識別するためのサポートが追加されました。
exchangeMessageTrace リソースの status プロパティを使用すると、
recalledを返すことができます。
2026 年 10 月: プレビューのみの新機能
バックアップと回復 |Microsoft 365 のバックアップとストレージ
- activityLogBase リソースとその派生型を使用して、ポリシーの変更、動的なルールの実行、オフボード、復元タスクの完了など、バックアップおよび復元リソースに関する管理アクティビティを追跡します。
メールボックスのインポートとエクスポート
- 非表示のメールボックス フォルダーを識別するために、mailboxFolder リソースに isHidden プロパティを追加しました。
-
フォルダーの一覧表示と子フォルダーの一覧表示には、既存の includeHiddenFolders クエリ パラメーターを使用します。 非表示フォルダーと非表示フォルダーの両方を含めるには、[
true] に設定します。
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 とアクセス | ディレクトリの管理
- 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 とサインイン
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 とアクセス | ディレクトリの管理
ID とアクセス | 社内
Get accessPackageResourceEnvironment メソッドが、委任されたアクセス許可で呼び出された場合にのみ SharePoint Online リソース環境を返すことを明確にしました。 SharePoint Online リソース環境は SharePoint ルート サイトに対応するため、アプリケーションのアクセス許可でルート サイト情報を取得するには、$filter=siteCollection/root ne null クエリ オプションと共に List sites メソッドを使用します。
- エージェント ID とゲスト ユーザーを管理するライフサイクル ポリシーのパブリック プレビュー サポートを追加しました。 lifecyclePolicy とその派生ポリシー タイプを使用して、スコープ、ルール、ワークフローの適用、影響評価、およびレポートの処理を構成します。
- ゲスト ユーザーのライフサイクル アクションを追加して、構成 証明、 サインイン ユーザーをスポンサーとして追加し、 サインイン ユーザーをスポンサーとして削除しました。
ID とアクセス | ID とサインイン
requireCertificateSidAlignment プロパティを x509CertificateAuthenticationMethodConfiguration リソースに追加しました。 証明書ベースの認証中にハイブリッド ユーザーとクラウド専用ユーザーに証明書 SID のアライメントを要求するために使用します。
People and workplace intelligence |分析
searchHit リソースの種類に sensitivityLabel プロパティを追加して、検索結果リソースの秘密度ラベル情報を提供しました。
レポート |パートナー課金レポート
CSP パートナーが特定の請求書に対して請求された集計された Azure 使用状況レポートを生成できるようにするための billedAggregatedUsage リソースの種類と関連するエクスポート メソッドを追加しました。
セキュリティ |データのセキュリティとコンプライアンス
ユーザーのコンピューティング保護スコープとテナント API のコンピューティング保護スコープで使用される userActivityTypes 列挙型にcontentFilteringメンバーを追加し、コンテンツを評価する前にアプリケーションがデータ損失防止ポリシーによってコンテンツ フィルタリングを管理するかどうかを判断できるようにします。
完了できなかったポリシー評価のレポートをサポートするために、 contentActivity リソースを更新しました。 執行平面は、既存のコンテンツ アクティビティの取り込み API を介して、構造化された不完全な検査理由を送信できます。
セキュリティ |監査ログのクエリ
- isRecordCountLimitExceeded、recordCountLimit、および approximateReturnedRecordCount プロパティを auditLogQuery リソースに追加しました。 これらのプロパティを使用して、完了したクエリが検索ごとのレコード数の制限を超えたかどうかを確認し、適用可能な制限とおおよその返されるレコード数を調べます。
チームワークとコミュニケーション |メッセージング
getAllRetainedMessages メソッドを更新して、テナントのプライベート チャネル ストレージの移行が完了した後にキャプチャされた保持プライベート チャネル メッセージ バージョンのサポートを文書化しました。
2026 年 8 月: 新機能と一般提供
アプリケーション
- authenticationBehaviors リソースの種類と coopEnforcement プロパティを v1.0 エンドポイントに追加しました。 アプリケーション所有者は、このプロパティを使用して、Cross-Origin-Opener-Policy の実施を明示的にテストしたり、互換性のないブラウザー認証フローを修正しながら適用を一時的に抑制したり、サービスの既定値に戻したりすることができます。 このプロパティはグローバル サービスでのみ使用でき、国内クラウド展開では使用できません。
- v1.0 でアプリケーション リソースの種類に authenticationBehaviors プロパティを追加しました。
$selectでのみ返されます。
変更通知 |サブスクリプション
- サブスクリプション リソースの種類の変更通知を Web プッシュ エンドポイント (RFC 8291) に配信するためのサポートが追加されました。
- Web プッシュ サブスクリプションの作成時に使用される VAPID 公開キー (RFC 8292) を取得する getVapidPublicKey メソッドを追加しました。
Files
- 1 回の要求で最大 20 個の columnDefinition オブジェクトを作成または更新できるように、fileStorageContainer リソース型に Upsert columns メソッドを追加しました。
- driveItem リソースの assignSensitivityLabel アクションに appliedByUser パラメーターを追加しました。 このパラメーターを使用すると、アプリのみの呼び出し元は、秘密度ラベルを適用する代わりにユーザー ID を指定できます。
ID とアクセス | ディレクトリの管理
- managerApplications プロパティを agentIdentity リソースと agentIdentityBlueprintPrincipal リソースに追加して、バッキング エージェント ID ブループリントを管理するアプリケーションを識別しました。
自動的に作成されたポイントインタイム スナップショットから重要な Microsoft Entra ディレクトリ オブジェクトをプログラムで回復するための回復リソースの種類と関連するメソッドを追加しました。 これらの API を使用して、使用可能なスナップショットの検査、復元前の変更のプレビューとスコープ設定、回復ジョブの実行、進行状況の監視、失敗した変更の確認を行います。
ID とアクセス | 社内
-
externalSapAcConnectionInfo 複合型と共に、サポートする authenticationInfo および clientCredentialAuthenticationInfo 型を追加して、Microsoft Entra エンタイトルメント管理から SAP Access Control (AC) システムへの接続を構成しました。
connectorType が
sapAcの場合、externalOriginResourceConnector の connectionInfo プロパティで設定します。 -
ライフサイクル ワークフローのプロビジョニングとワークフローのサブジェクト API をベータ版から v1.0 に昇格し、ワークフロー用に、より広範で拡張可能なサブジェクト モデルを導入し、サブジェクトごとの処理結果を表示します。 昇格されたサーフェスには次のものが含まれます。
- workflowSubject の基本型とその プロビジョニングObjectWorkflowSubject および directoryObjectWorkflowSubject 派生型
- 実行リソースとワークフロー リソースで subjectProcessingResults ナビゲーション プロパティを持つ subjectProcessingResult リソース
- subjectSummary リソースと subjectProcessingResult リソースの集計メソッド
- awaitedWorkflowProcessingResult リソースを返す activateAndWait アクション
- provisioningAttributeMapping リソースと attributeSetEntry リソース
- customTaskExtensionResponseData リソース、customTaskExtension の replyMode プロパティ、および customTaskExtensionCalloutData の targetSubject プロパティ
- workflowBase の targetSubjectType プロパティと taskProcessingResult の workflowSubject プロパティ
-
subjectType 列挙型と customTaskExtensionReplyMode 列挙型、および
extensibility列挙メンextensibilityOnDemand
- Microsoft Entra エンタイトルメント管理から SAP Identity Access Governance (SAP IAG) への接続を作成、一覧表示、取得、更新、削除するための externalOriginResourceConnector リソースの種類とメソッドを追加しました。 SAP IAG コネクタの場合は、SAP IAG エンドポイント、OAuth トークン エンドポイント、クライアント ID と、クライアント シークレットが格納されている場所を識別する Azure サブスクリプション、リソース グループ、キー コンテナー、シークレットを指定します。 コネクタはアクセス パッケージ リソースに関連付けられているため、資格管理はアクセス パッケージを使用して SAP IAG のリソースへのアクセスをプロビジョニングできます。
- reviewerId プロパティと scopeType プロパティを accessReviewReviewerScope に追加して、レビュー担当者を直接、またはクエリではなく既知のスコープとして指定できるようにしました。
- 決定を適用した結果を記述するために、 applyDescription プロパティを accessReviewInstanceDecisionItem に追加しました。
- レビュー中のアプリ ロールを識別するために、 appRoleId プロパティと appRoleDisplayName プロパティを accessReviewInstanceDecisionItemServicePrincipalResource に追加しました。
- errors プロパティー を accessReviewInstance に追加し、リソース・タイプ accessReviewError を追加して、レビュー・インスタンスのライフサイクル中に発生したエラーを報告します。
- accessReviewPrincipalScope、accessReviewResourceScope、および accessReviewAccessPackageAssignmentPolicyScope リソースの種類を追加しました。 principalResourceMembershipsScope の principalScopes プロパティおよび resourceScopes プロパティでこれらを使用して、クエリ式を記述せずに、どのプリンシパルがどのリソースにアクセス権を持っているかを判断します。
- accessReviewPrincipalScopeType、accessReviewResourceScopeType、およびaccessReviewReviewerScopeType 列挙型を追加して、既知のプリンシパル、リソース、およびレビュー担当者スコープを識別しました。
ID とアクセス | ID とサインイン
クロス テナント アクセス ポリシーで、Microsoft 365 クロステナント機能を管理するためのサポートが追加されました。 m365CapabilityBase リソースと m365Capabilities リレーションシップを使用して、テナント間で有効になっている Microsoft 365 エクスペリエンス (予定表の共有、メールヒント、場所の予約、テナント間の移行など) を管理します。 既定のポリシーでは、機能を 一覧表示、 作成、 更新 できます。 パートナー ポリシーでは、機能 の一覧表示、 作成、 更新、 削除 を行うことができます。
メール
- ユーザーの Notes フォルダー内のクイックキャプチャ ノートを一覧表示、作成、取得、更新、削除するノート リソースの種類とメソッドを追加しました。 差分クエリを使用して、前回の要求以降に追加、更新、または削除されたメモを同期します。 また、インライン画像添付ファイルの 一覧表示、 追加、 削除、オープン または従来の拡張プロパティを使用して、カスタム データをノートに格納することもできます。
セキュリティ |アラートとインシデント
- userAccount リソースに tenantId プロパティを追加して、アラートの証拠が processEvidence、userEvidence、または mailboxEvidence に関連しているセキュリティ アラートで示された侵害されたユーザー アカウントの Entra ホーム テナント ID を提供します。
- アラートの移動と Microsoft Defender でのインシデントのマージをサポートするために、アラート: moveAlerts と incident: mergeIncidents アクションを追加しました。
- correlationReason 列挙型と mergeResponse リソースの種類を追加しました。
セキュリティ |電子情報開示
additionalDataOptions 列挙型に cloudNativeHtmlConversion メンバーを追加しました。
メールボックスのインポートとエクスポート
- v1.0 で mailboxFolder リソースの種類に wellKnownName プロパティを追加しました。 ロケールに依存しない名前を使用して Outlook によって作成されたフォルダーを識別するには、このプロパティを使用します。
- v1.0 で mailboxItem リソースの種類に Delete mailboxItem メソッドを追加しました。 Exchange の論理的な削除または物理的な削除のセマンティクスを持つメールボックス フォルダから個々のメールボックス アイテムを削除するには、このメソッドを使用します。
セキュリティ
従来の Microsoft Graph セキュリティ アラート API の廃止日を 2026 年 8 月 31 日から 2026 年 10 月 15 日に更新しました。
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 プロパティを追加して、検索結果リソースの秘密度ラベル情報を提供しました。
セキュリティ
detectionAction リソースと incidentConfiguration 複合型に incidentConfiguration プロパティを追加しました。 この設定を使用して、カスタム検出ルールによって生成されたアラートを自動インシデント相関から除外し、スタンドアロンの単一アラート インシデントを作成します。
セキュリティ |監査ログのクエリ
- isRecordCountLimitExceeded、recordCountLimit、および approximateReturnedRecordCount プロパティを auditLogQuery リソースに追加しました。 これらのプロパティを使用して、完了したクエリが検索ごとのレコード数の制限を超えたかどうかを確認し、適用可能な制限とおおよその返されるレコード数を調べます。
セキュリティ |データのセキュリティとコンプライアンス
ユーザーのコンピューティング保護スコープとテナント API のコンピューティング保護スコープで使用される userActivityTypes 列挙型にcontentFilteringメンバーを追加し、コンテンツを評価する前にアプリケーションがデータ損失防止ポリシーによってコンテンツ フィルタリングを管理するかどうかを判断できるようにします。
policyScopeBase リソースの種類に policyConfiguration プロパティを追加しました。 適用平面では、保護スコープ API によって返される有効な既定のセキュリティ構成を使用して、ポリシーの評価を完了できない場合にコンテンツを監査するかブロックするかを決定できます。
完了できなかったポリシー評価のレポートをサポートするために、 contentActivity リソースを更新しました。 執行平面は、既存のコンテンツ アクティビティの取り込み 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 コミュニティ ページにアクセスしてください。
調査パネルに参加して、開発者エクスペリエンスに関するご意見をお寄せください。