Microsoft Graph の新機能
Microsoft Graph には、Microsoft 365、Windows、Enterprise Mobility + Securityのデータにアクセスするために使用できる統合プログラミング モデルが用意されています。 この記事では、Microsoft Graph API、ドキュメント、SDK などの新機能について説明します。
API レベルの更新プログラムの詳細については、Microsoft Graph API変更ログを参照してください。
Microsoft Graph の以前の更新プログラムの詳細については、「 Microsoft Graph の新しい履歴」を参照してください。
重要
プレビュー状態の機能は予告なく変更される可能性があり、一般公開 (GA) 状態に昇格されない場合があります。 運用アプリではプレビュー機能を使用しないでください。
2024 年 10 月: 新規および一般公開
バックアップ ストレージ
次のメソッドのエンドポイントを更新しました。
ID とアクセス | ディレクトリの管理
サブドメインのルート ドメインを取得します。
directoryRole と directoryRoleTemplate の代わりに unifiedRoleDefinition で統合 RBAC API を使用するための推奨事項が追加されました。
セキュリティ |電子情報開示
- 電子情報開示検索: purgeData メソッドで Exchange メールボックスアイテムの削除を有効にしました。
- メンバーを
permanentlyDeleted
purgeType 列挙permanentlyDelete
から削除しました。
チームワークとコミュニケーション |アプリ
teamsAppAuthorization の clientAppId プロパティを使用して、Microsoft Teams アプリ カタログ内のアプリに関連付けられているMicrosoft Entra アプリ ID の登録 ID を取得します。
チームワークとコミュニケーション |メッセージング
chatMessage: delta メソッドを更新し、ユーザーが参加者であるすべてのチャット (1 対 1 チャット、グループ チャット、会議チャットなど) からデルタ メッセージの一覧を取得する新しいエンドポイントを使用しました。
2024 年 10 月: プレビューのみ新規
バックアップ ストレージ
保護ポリシーに保護ユニットを一括追加するための新しいエンドポイントを追加しました。
次のメソッドのエンドポイントを更新しました。
デバイスとアプリの管理 | クラウド PC
-
$select
cloudPC: getProvisionedCloudPC メソッドのクエリ パラメーターを有効にしました。 - cloudPcUserSetting の notificationSetting プロパティを使用して、クラウド PC ユーザーのクラウド PC 通知プロンプトを定義します。
レポート | ID およびアクセス レポート
Microsoft Entra正常性監視アラート API を使用すると、テナントのビジネス クリティカルな ID シナリオで異常な使用パターンを検出し、アラート通知を受信できます。 アラートとアラート構成を取得および更新するには、アラートと alertConfiguration リソースの操作を使用します。 詳細については、 関連する変更ログに関するセクションを参照してください。
セキュリティ |電子情報開示
- 電子情報開示検索: purgeData メソッドで Exchange メールボックスアイテムの削除を有効にしました。
- メンバーを
permanentlyDeleted
purgeType 列挙permanentlyDelete
から削除しました。
チームワークとコミュニケーション |通話とオンライン会議
- virtualEventRegistrationの externalRegistrationInformation プロパティを使用して、仮想イベント登録の外部情報を取得または設定します。
- virtualEventTownhall 型の仮想イベントには、次の新しいメソッドを使用します。
デバイスとアプリの管理 |クラウド ライセンス
- クライアントとワークロードのライセンス チェック用に設計された新しいクラウド ライセンス usageRight エンティティを使用します。リレーションシップは、ユーザーまたはグループから usageRight にフローするように構成されています。 この新しいエンティティでは、次の操作がサポートされます。
- グループまたはユーザーの cloudLicensing プロパティを使用して、クラウド ライセンス リソースとの関係を取得します。
チームワークとコミュニケーション |メッセージング
- chatMessage: delta メソッドを更新し、ユーザーが参加者であるすべてのチャット (1 対 1 チャット、グループ チャット、会議チャットなど) からデルタ メッセージの一覧を取得する新しいエンドポイントを使用しました。
- 1 つの要求でチームから複数のメンバーを削除します。
ユーザー
Microsoft Graph で読み取り専用だった ユーザー リソースの種類の次のオンプレミス同期プロパティを、Microsoft Graph 経由で更新可能に変更しました。
- onPremisesDistinguishedName
- onPremisesDomainName
- onPremisesSamAccountName
- onPremisesSecurityIdentifier
- onPremisesUserPrincipalName
2024 年 9 月: 新規および一般公開
変更通知
Microsoft Graph の変更通知の Event Hubs を認証するための共有アクセス署名 (SAS) の廃止を発表しました。 代わりにMicrosoft Entra IDロールベースのアクセス制御 (RBAC) を使用することをお勧めします。 ガイダンスに従って RBAC に移行します。
ID とアクセス | ディレクトリの管理
以前に非推奨になった Directory.Write.Restricted
アクセス許可を 、デバイス、 グループ、 およびユーザー リソースから削除しました。
セキュリティ |アラートとインシデント
- コンピューターが属する DNS ドメインを取得するには、deviceEvidence の dnsDomain プロパティを使用します。
- ドメイン サフィックスのないホスト名を取得するには、deviceEvidence の hostName プロパティを使用します。
- deviceEvidence で ntDomain プロパティを使用して、Microsoft Windows ネットワーク内のコンピューターの論理グループを取得します。
セキュリティ |ID
顧客の Defender for Identity 構成内で特定される潜在的な問題Microsoft Defender for Identity表す正常性の問題を取得、一覧表示、更新する機能を追加しました。
チームワークとコミュニケーション |メッセージング
- チーム内のすべてのチャネルにわたって保持されているすべてのメッセージを取得します。
- 1 対 1 のチャット、グループ チャット、会議チャットなど、ユーザーが参加しているすべてのチャットから保持されているすべてのメッセージを取得します。
2024 年 9 月: プレビューのみの新規
アプリケーション |サービス プリンシパル
applicationTemplate: instantiate メソッドで serviceManagementReference オプション プロパティを使用して、サービスのサービス ツリー ID を設定します。
デバイスとアプリの管理 | クラウド PC
-
middleEast
cloudPcRegionGroup 列挙でサポートされているリージョンとして およびmexico
メンバーを有効にしました。 - cloudPC リソースから getShiftWorkCloudPcAccessState メソッドを削除しました。 今後は、 getFrontlineCloudPcAccessState API を 使用します。
- cloudPcProvisioningPolicy の autopilotConfiguration プロパティを使用して、Windows Autopilot の設定を取得または設定し、Windows 365のお客様がクラウド PC で体験できるようにします。
- オペレーティング システムバージョンのイメージを取得するには、cloudPcDeviceImage リソースと cloudPcGalleryImage リソースの osVersionNumber プロパティを使用します。
- cloudPC リソースで retrieveSnapshots メソッドを導入し、クラウド PC のすべてのスナップショットの一覧を返せるようにしました。
次のメソッドを非推奨にしました。
- bulkSetReviewStatus;代わりに、 cloudPcBulkSetReviewStatus リソースとそのサポートされている API を使用してください。
- スナップショットを一覧表示します。代わりに、 retrieveSnapshots リソースとそのサポートされている API を使用してください。
ファイル
- fileStorageContainer のごみ箱設定を更新します。
- 、、
$orderBy
、$filter
およびincludeAllContainerUsers
クエリ パラメーターを$skip
$top
使用して、アクセス許可の一覧表示操作の応答をカスタマイズします。 - ドライブ項目をコピーするときに、すべてのバージョン履歴を含めます。 バージョン履歴は、ターゲット バージョン設定の制限まで含まれます。
ID とアクセス | ディレクトリの管理
internalDomainFederation の passwordResetUri プロパティを使用して、クライアントがパスワードをリセットするためにリダイレクトされる URI を取得または設定します。
ID とアクセス |ID とサインイン
- tenantAppManagementPolicy リソースの取得および更新操作で identifierUris プロパティを使用して、アプリケーションの脆弱または簡単に侵害された識別子 URI 形式に対する制限を取得または設定します。
- tenantAppManagementPolicy リソースの applicationRestrictions プロパティの戻り値の型を appManagementConfiguration から appManagementApplicationConfiguration に更新しました。
- tenantAppManagementPolicy リソースの servicePrincipalRestrictions プロパティの戻り値の型を appManagementConfiguration から appManagementServicePrincipalConfiguration に更新しました。
- appManagementPolicy リソースの restrictions プロパティの戻り値の型を appManagementConfiguration から customAppManagementConfiguration に更新しました。
レポート | Microsoft 365 の使用状況レポート
- Microsoft 365 Copilot アプリの有効なユーザーの最新のアクティビティ データを取得します。
- 指定した期間のMicrosoft 365 Copilotのアクティブおよび有効なユーザーの集計数を取得します。
- 指定した期間のMicrosoft 365 Copilotのアクティブなユーザーと有効なユーザーの 1 日あたりの数の傾向を取得します。
セキュリティ |アラートとインシデント
- コンピューターが属する DNS ドメインを取得するには、deviceEvidence の dnsDomain プロパティを使用します。
- ドメイン サフィックスのないホスト名を取得するには、deviceEvidence の hostName プロパティを使用します。
- deviceEvidence で ntDomain プロパティを使用して、Microsoft Windows ネットワーク内のコンピューターの論理グループを取得します。
セキュリティ |ID
- 新しいデプロイ アクセス キーを生成します。
- Microsoft Defender for Identityに関連付けられているデプロイ アクセス キーを取得します。
- センサーデプロイ パッケージを取得する URL とバージョン。
チームワークとコミュニケーション |通話とオンライン会議
incomingCallOptions と outgoingCallOptions の isDeltaRosterEnabled プロパティを使用して、デルタ 名簿が呼び出しに対して有効かどうかを示します。
Microsoft Graph に投稿する
Microsoft Graph でのサポートを希望するシナリオがある場合は、
Microsoft Graph フィードバック ポータルを使用して、新機能の提案と投票を行います。 新機能の中には、開発者コミュニティでの要望が高かったことがきっかけとなり開発されたものがあります。 Microsoft Graph チームは、顧客のニーズを定期的に評価し、ベータ () および v1.0 (
https://graph.microsoft.com/beta
https://graph.microsoft.com/v1.0
) エンドポイントに新機能をリリースします。毎週の Microsoft 365 プラットフォーム コミュニティコールに参加し、Microsoft Graph コミュニティのアクティブなメンバーになります。 開発者の呼び出しの完全な予定表を確認するには、 Microsoft 365 および Power Platform コミュニティ ページを参照してください。
研究パネルに参加して、開発者エクスペリエンスに関するご意見をお知わせください。