Microsoft Graph の新機能
Microsoft Graph には、Microsoft 365、Windows、Enterprise Mobility + Securityのデータにアクセスするために使用できる統合プログラミング モデルが用意されています。 この記事では、Microsoft Graph API、ドキュメント、SDK などの新機能について説明します。
API レベルの更新プログラムの詳細については、Microsoft Graph API変更ログを参照してください。
Microsoft Graph の以前の更新プログラムの詳細については、「 Microsoft Graph の新しい履歴」を参照してください。
重要
プレビュー状態の機能は予告なく変更される可能性があり、一般公開 (GA) 状態に昇格されない場合があります。 運用アプリではプレビュー機能を使用しないでください。
2025 年 2 月: 新規および一般公開
デバイスとアプリの管理 |クラウド印刷
printSettings で printerDiscoverySettings プロパティを使用して、ユニバーサル印刷の使用時にプリンターの検出に影響する設定を指定します。
セキュリティ
サポートされているアラート証拠として teamsMessageEvidence を追加しました。
セキュリティ |電子情報開示
- 電子情報開示HoldPolicy リソースの更新操作でサポートされているパラメーターとして contentQuery を有効にしました。
- userSource オブジェクトまたは siteSource オブジェクトを一覧表示および削除します。
- unifiedGroupSource を削除します。
チームワークとコミュニケーション |通話とオンライン会議
- Teams ライブ イベントの記録を取得します。
- onlineMeeting の更新操作でサポートされているプロパティとして、allowRecording、allowTranscription、anonymizeIdentityForRoles、broadcastSettings、および watermarkProtection を有効にしました。
チームワークとコミュニケーション |メッセージング
- 共有チャネルの直接メンバーと間接メンバーを含め、チャネルからすべてのメンバーを取得します。
- インストールされているアプリで 1 対 1 のチャットを作成します。
- RSC が付与したアプリとの 1 対 1 のチャットを作成します。
2025 年 2 月: プレビューのみ新規
バックアップ ストレージ
- driveProtectionUnit、mailboxProtectionUnit、siteProtectionUnit の protectionSources プロパティを使用して、保護ユニットが現在保護されているソースを取得します。
- driveProtectionRule または mailboxProtectionRule を更新します。
- driveProtectionRule または mailboxProtectionRule 内の動的ルールによって保護されているすべての成果物を削除して保護解除します。
- create driveRestoreArtifactsBulkAdditionRequests メソッドを使用するときに、サポートされているプロパティとして directoryObjectIdsプロパティとドライブ プロパティを有効にしました。
- メールボックスの作成RestoreArtifactsBulkAdditionRequest メソッドを使用するときに、サポートされているプロパティとして directoryObjectIdsプロパティとメールボックス プロパティを有効にしました。
- siteRestoreArtifactsBulkAdditionRequests メソッドを使用するときに、サポートされているプロパティとして siteIds プロパティと siteWebUrls プロパティを有効にしました。
セキュリティ |電子情報開示
- 電子情報開示 API のさまざまなリソースとアクションでサポートされているプロパティとパラメーターとして、 itemsToInclude、 cloudAttachmentVersion、 documentVersion、 additionalDataOptions、 statisticsOptions を追加しました。
- 電子情報開示HoldPolicy リソースの更新操作でサポートされているパラメーターとして contentQuery を有効にしました。
- userSource オブジェクトまたは siteSource オブジェクトを一覧表示および削除します。
- unifiedGroupSource を削除します。
デバイスとアプリの管理 | クラウド PC
- アクセスできないクラウド PC の傾向に関する毎週のリージョン集計レポートを取得します。
- クラウド PC のトラブルシューティング レポートを取得します。
ID とアクセス | ID とサインイン
カスタム認証拡張機能を管理するための次の API 操作が置き換えられました。
古いエンドポイント | 推奨されるエンドポイント |
---|---|
GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionStartListener/handler/microsoft.graph.onAttributeCollectionStartCustomExtensionHandler/customExtension GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionSubmitListener/handler/microsoft.graph.onAttributeCollectionSubmitCustomExtensionHandler/customExtension GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.OnEmailOtpSendListener/handler/microsoft.graph.OnOtpSendCustomExtensionHandler/customExtension
|
GET /identity/customAuthenticationExtensions/{customAuthenticationExtensionId} |
PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionStartListener/handler/microsoft.graph.onAttributeCollectionStartCustomExtensionHandler/customExtension/$ref PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionSubmitListener/handler/microsoft.graph.onAttributeCollectionSubmitCustomExtensionHandler/customExtension/$ref PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onEmailOtpSendListener/handler/microsoft.graph.onOtpSendCustomExtensionHandler/customExtension/$ref |
PATCH /identity/customAuthenticationExtensions/{customAuthenticationExtensionId} |
セキュリティ
サポートされているアラート証拠として teamsMessageEvidence を追加しました。
サイトとリスト
サイトに対するアプリケーションのアクセス許可 Sites.Archive.All
を有効にしました 。アーカイブ メソッドと サイト: 非アーカイブ メソッド。
タスクとプラン
- Teams の共有チャネルが所有するプランPlanner一覧表示します。
-
list businessScenarioTasks メソッドの要求 URL を更新し、要求のスコープを externalObjectId、externalContextId、または groupId に
$filter
クエリ パラメーターを要求するようにしました。
チームワークとコミュニケーション |通話とオンライン会議
onlineMeeting の更新操作でサポートされているプロパティとして、allowRecording、allowTranscription、anonymizeIdentityForRoles、broadcastSettings、および watermarkProtection を有効にしました。
チームワークとコミュニケーション |メッセージング
- チャネルのすべてのメンバーを取得するための、次のより詳細な委任されたアクセス許可とアプリケーションアクセス許可が導入されました。
- 委任されたアクセス許可の代わりに、委任された
ChannelMember.Read.All
アクセス許可Group.Read.All
使用します。 - リソース固有の同意には、
ChannelMember.Read.Group
とChannelMember.ReadWrite.Group
アプリケーションのアクセス許可を使用します。
- 委任されたアクセス許可の代わりに、委任された
- RSC が付与したアプリとの 1 対 1 のチャットを作成します。
2025 年 1 月: 新規および一般公開
ファイル
fileStorageContainer: restore メソッドのエンドポイントを更新しました。
ID とアクセス | ID とサインイン
サービス プリンシパルの不審な API トラフィック検出に riskEventType エントリを追加しました。
Microsoft Graph Bicep テンプレート
これで、コードとしてのインフラストラクチャ (IaC) プロジェクト用の Bicep テンプレートにユーザー リソースをデプロイできるようになりました。 詳細については、「 Microsoft.Graph ユーザー Bicep リファレンス」を参照してください。
チームワークとコミュニケーション |通話とオンライン会議
- Microsoft Teamsカスタム会議テンプレートを使用すると、会議の開催者が使用できる多くの会議オプションの値を指定できます。 onlineMeeting で meetingTemplateId プロパティを使用して、会議テンプレートを使用してオンライン会議を作成します。
- allowBreakoutRooms、allowLiveShare、allowPowerPointSharing、allowWhiteboard を使用して、ブレークアウト ルーム、ライブ共有、PowerPointライブ、ホワイトボード機能が onlineMeeting または virtualEventSession で有効になっているかどうかを示します。
- onlineMeeting で allowedLobbyAdmitters プロパティを使用して、ロビーから許可できるユーザーを取得または設定します。
- onlineMeeting および virtualEventSession の allowRecording プロパティと allowTranscription プロパティを使用して、会議または仮想イベント セッションで記録または文字起こしが有効かどうかを示します。
チームワークとコミュニケーション |メッセージング
- すべてのユーザー向けの@mentionを含むチャット メッセージを取得します。
- 転送されたメッセージを添付ファイルとして含むチャット メッセージを取得します。
- isHiddenForAllMembers プロパティを使用して、チャットがすべてのメンバーから非表示かどうかを示します。
2025 年 1 月: プレビューのみ新規
変更通知
aiInteraction のサブスクリプションを一覧表示、取得、作成、更新、削除、および再認証するメソッドに対する変更通知のサポートを有効にしました。
デバイスとアプリの管理 | クラウド PC
- 選択したクラウド PC で一括アクションを再試行します。
- cloudPC の productType プロパティを使用して、クラウド PC の製品の種類を取得するか、製品の種類でクラウド PC をフィルター処理します。
- getCloudPcTenantMetricsReport メソッドを優先して、cloudPcReports リソースの getCloudPcPerformanceReport メソッドを非推奨にしました。
ファイル
fileStorageContainer: restore メソッドのエンドポイントを更新しました。
ID とアクセス | ディレクトリの管理
- デバイスの代替名を取得または設定するには、デバイスの alternativeNames プロパティを使用します。
- deviceTemplate リソースとそれに関連付けられているメソッドを使用して、Microsoft Entra ID内のデバイスのデバイス テンプレートを管理します。
- mutualTlsOauthConfiguration リソースとそれに関連付けられているメソッドを使用して、mTLS に使用される特定のオブジェクト セットに対して証明書を発行できる証明機関を管理します。
ID とアクセス | ID とサインイン
次のオブジェクトを使用して、Microsoft Entra 外部 IDでワンタイム パスコード (OTP) のカスタム 電子メール プロバイダーを構成するためのサポートを追加しました。
- onOtpSendCustomExtension リソースの種類は、Azure 関数である可能性がある外部サービスの構成の詳細を含むカスタム認証拡張機能を構成します。
- onEmailOtpSendListener リソースの種類は、onOtpSendCustomExtension オブジェクトの構成の詳細に基づいて、OTP プロンプトをユーザーに送信するようにトリガーされるイベント リスナーを構成します。
この機能を使用すると、カスタム認証拡張機能が正常に呼び出されない場合に、既定のフォールバック オプションを構成することもできます。
業界データ ETL
industryDataRun リソースの開始操作を使用してオンデマンド実行を実行します。調整制限は 12 時間ごとに最大 5 回成功します。
メールボックスのインポートとエクスポート
Microsoft Graph の新しいメールボックスのインポートおよびエクスポート API を使用して、データのインポートとエクスポートのシナリオでメールボックス リソースと統合するソリューションを構築します。 詳細については、「 Microsoft Graph でのメールボックスのインポートおよびエクスポート API の概要」を参照してください。
レポート | ID およびアクセス レポート
appliedAuthenticationEventListener リソースの eventType プロパティのサポートされる値として、attributeCollectionStart
、attributeCollectionSubmit
、およびemailOtpSend
を追加しました。
サイトとリスト
SharePoint サイトをアーカイブまたはアーカイブ解除します。
タスクとプラン
teamsChannel コンテナーの種類を使用して、Microsoft Teamsの共有チャネルにプランを作成します。
チームワークとコミュニケーション |通話とオンライン会議
緊急通報イベントの更新に関する変更通知Microsoft Teams取得します。
チームワークとコミュニケーション |メッセージング
Microsoft Loop コンポーネントを 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 コミュニティ ページを参照してください。
研究パネルに参加して、開発者エクスペリエンスに関するご意見をお知わせください。