Microsoft Graph の新機能
Microsoft Graph には、Microsoft 365、Windows、Enterprise Mobility + Securityのデータにアクセスするために使用できる統合プログラミング モデルが用意されています。 この記事では、Microsoft Graph API、ドキュメント、SDK などの新機能について説明します。
API レベルの更新プログラムの詳細については、Microsoft Graph API変更ログを参照してください。
Microsoft Graph の以前の更新プログラムの詳細については、「 Microsoft Graph の新しい履歴」を参照してください。
重要
プレビュー状態の機能は予告なく変更される可能性があり、一般公開 (GA) 状態に昇格されない場合があります。 運用アプリではプレビュー機能を使用しないでください。
2024 年 4 月: 新規および一般公開
アプリケーション
新しいアプリケーションの signInAudience の既定値 を から
AzureADandPersonalMicrosoftAccount
にAzureADMyOrg
更新しました。 今後、 アプリの作成時にプロパティに値を明示的に割り当てない場合、アプリには 値 が自動的にAzureADMyOrg
割り当てられます。アプリの作成時にアプリケーションにパスワード シークレットを追加するためのサポートを追加しました。 以前は、 Update アプリケーション または addPassword 操作を使用して、既存のアプリにのみシークレットを追加できました。
upsert 機能を使用して、 アプリケーション、 federatedIdentityCredential、または servicePrincipal が存在しない場合は作成するか、クライアントが指定したキーを使用して既存のオブジェクトを更新します。 詳細については、次の API 操作を参照してください。
ID とアクセス | 社内
ワークフロー リソースに対するCreate操作を使用して、以前の上限の 50 から増加したワークフローを最大 100 個作成します。
ID とアクセス | ID とサインイン
Microsoft Entra ID B2B コラボレーションの引き換えフロー設定で使用する既定の ID プロバイダーを構成します。
グループ
グループ リソースの種類にアップサート機能を追加しました。 この機能を使用して、存在しない場合はグループを作成するか、 uniqueName クライアントが提供するキーを使用して既存のグループを更新します。
セキュリティ |従来のアラート
エンドポイントは /security/alerts
非推奨であり 、2026 年 4 月 10 日にデータの返しを停止します。
サイトとリスト
今後は次のことができるようになりました。
サイト ページとページの水平セクションと垂直セクションを操作します。
ユーザー
テナント内のゲスト ユーザーの特権のスポンサーとしてユーザーまたはグループを関連付け、ゲスト ユーザーの情報とアクセスを更新したままにします。 スポンサーの割り当て、スポンサーの一覧表示、スポンサーの削除を行うことができます。
2024 年 4 月: プレビューのみ新規
デバイスとアプリの管理 | クラウド PC
- cloudPC の allotmentDisplayName プロパティを使用して、テナント ライセンスをより小さなバッチまたはグループに分割し、特定の割り当てで使用できるライセンスの数を制限します。
- resourceType プロパティを優先して、cloudPcAuditResource の type プロパティを非推奨にしました。
ID とアクセス | 社内
ワークフロー リソースに対するCreate操作を使用して、以前の上限の 50 から増加したワークフローを最大 100 個作成します。
ID とアクセス |ネットワーク アクセス
BranchSite リソースの種類から remoteNetwork リソースの種類に、グローバル セキュリティで保護されたアクセス サービスの顧客のオンプレミス機器の物理的な場所の定義を更新しました。 branchSite リソースの種類とそれに関連付けられているプロパティ、リレーションシップ、エンドポイントは、間もなく廃止される予定です。 remoteNetwork リソースの種類とそれに関連付けられているプロパティ、リレーションシップ、エンドポイントを使用します。
業界データ ETL
学校データ同期が Microsoft 365 と Microsoft Entra ID のデータを設定する方法を構成するために使用される送信プロビジョニング フローのコレクションを表す送信プロビジョニング フロー セットが一般公開されました。
送信プロビジョニング フロー セットには、userProvisioningFlow、classGroupProvisioingFlow、securityGroupProvisioingFlow、administrativeUnitProvisioingFlow の各プロビジョニング フロー構成のうち、1 つ以下を含めることができます。
業界データ ETL API を呼び出すときは、新しいアクセス許可 と IndustryData-OutboundFlow.ReadWrite.All
を使用して、送信プロビジョニング フロー セット データの読み取りまたは書き込みに追加されたより詳細なアクセス許可IndustryData-OutboundFlow.Read.All
を利用します。
連絡先と職場のインテリジェンス | 連絡先
/organization/{organizationId}/settings/itemInsights
新しい peopleAdminSettings リソースを優先してエンドポイントを非推奨にし、peopleAdminSettings リソースに List メソッドを導入しました。
レポート | ID およびアクセス レポート
以前に非推奨となった activeUsersBreakdownMetric リソースとそれに関連する API は廃止されました。 テナントに登録されている、顧客向けにMicrosoft Entra 外部 ID用に構成されているアプリの毎日および毎月のユーザー アクティビティに関する分析情報を取得するには、activeUsersMetric リソースの種類とそれに関連付けられている API を使用します。
セキュリティ |従来のアラート
エンドポイントは /security/alerts
非推奨であり 、2026 年 4 月 10 日にデータの返しを停止します。
セキュリティ |脅威インテリジェンス インジケーター
エンドポイントは /security/tiindicators
非推奨であり 、2026 年 4 月 10 日にデータの返しを停止します。
チームワークとコミュニケーション |メッセージング
チャネルで chatMessage を送信するか、 ファイル共有リンクを使用して添付ファイルを含むチャットを送信します。
2024 年 3 月: 新規および一般公開
アプリケーション
同期ジョブとして一括アップロードを実行して、Microsoft Entra ID同期サービスにデータを取り込みます。
クロスデバイス エクスペリエンス
Windows 設定と Windows 設定インスタンスを一覧表示および取得する機能を追加しました。
デバイスとアプリの管理 | クラウド PC
- cloudPC で、一覧表示、取得、猶予期間の終了、再起動、名前変更、復元、トラブルシューティングの各操作を利用できるようになりました。
- cloudPcAuditEvent で一覧表示操作と取得操作を使用できるようになりました。
- プロビジョニング ポリシー操作の一覧表示、取得、作成、更新、削除、割り当てを cloudPcProvisioningPolicy で使用できるようになりました。
- cloudPcUserSetting で、ユーザー設定の一覧表示、取得、作成、更新、削除、および割り当て操作を使用できるようになりました。
- cloudPcDeviceImage で、ソース イメージの一覧表示、取得、作成、削除、および取得の各操作を使用できるようになりました。
- cloudPcGalleryImage で一覧表示と取得操作を使用できるようになりました。
教育 |割り当て
$expand
EducationAssignment メソッドのクエリ パラメーターを有効にしました。
ID とアクセス | ディレクトリの管理
- organization エンティティから tenantType が返
CIAM
され、顧客テナントのMicrosoft Entra IDとして設定されているテナント、顧客 ID & アクセス管理 (CIAM) ソリューションが識別されるようになりました。 - デバイス リソースのIntuneによって設定される新しいプロパティ:enrollmentType、isRooted、managementType。
レポート |パートナーの請求レポート
課金済みのReconciliation: export API を使用して、請求された請求書調整データにアクセスします。
2024 年 3 月: プレビュー版のみ
セキュリティ | 攻撃のシミュレーションとトレーニング
トレーニング キャンペーン API を使用して、セキュリティ トレーニングをユーザーに直接割り当てます。
アプリケーション
upsert 機能を使用して、 アプリケーション、 federatedIdentityCredential、または servicePrincipal が存在しない場合は作成するか、クライアントが指定したキーを使用して既存のオブジェクトを更新します。 詳細については、次の API 操作を参照してください。
デバイスとアプリの管理 | クラウド PC
- 指定したポリシーに基づき、すべてのクラウド PC デバイスに現在のプロビジョニング ポリシー構成を適用します。
- ID を使用して、特定のクラウド PC デバイスセットのプロビジョニング ポリシー構成を更新します。
- 指定した alertRecord オブジェクトを isPortalNotificationSent プロパティを介して送信済みとしてマークする機能を追加しました。
- 一括 電源オフ、 電源オン、 再プロビジョニング、 サイズ変更、 再起動、 復元、および ID を使用したクラウド PC デバイスでのアクションの トラブルシューティング を実行します。
次のプロパティは非推奨になりました。
- cloudPcOnPremisesConnection の type プロパティ。代わりに connectionType プロパティを使用してください。
- cloudPcOnPremisesConnection の healthCheckStatusDetails プロパティ。代わりに healthCheckStatusDetail プロパティを使用します。
- cloudPcOnPremisesConnectionHealthCheck の additionalDetails プロパティ。代わりに additionalDetail プロパティを使用してください。
- domainJoinConfigurations プロパティを優先 する cloudPcProvisioningPolicy の domainJoinConfiguration プロパティ。
- domainJoinConfigurations プロパティを優先する cloudPcProvisioningPolicy の onPremisesConnectionId プロパティ。
デバイスとアプリの管理 |デバイスの更新
Windows 製品の Windows Updates API に、時間範囲別の既知の問題の取得、カタログ ID による製品リビジョンの検索、サポート情報番号によるメソッドを追加しました。
Files
リダイレクト URL を取得するのではなく、ファイル コンテンツを直接ダウンロードするには、 contentStream でファイルを取得するメソッドを 302
使用します。
グループ
グループ リソースの種類にアップサート機能を追加しました。 この機能を使用して、存在しない場合はグループを作成するか、 uniqueName クライアントが提供するキーを使用して既存のグループを更新します。
ID とアクセス | ID とサインイン
フェデレーション認証トークンを検証するかどうかを管理するには、federatedTokenValidationPolicy リソースの種類とそれに関連付けられているメソッドMicrosoft Entra ID使用します。
セキュリティ |Emailとコラボレーションの保護
Microsoft Defender for Office 365によって分析されたメールを一覧表示し、電子メール関連のメタデータを取得し、応答アクション (論理的な削除、ハード削除、迷惑メールへの移動、受信トレイへの移動) を実行する機能を追加しました。
セキュリティ |Id
正常性の問題の取得、一覧の取得、更新Microsoft Defender for Identity機能を追加しました。
ユーザー
convertExternalToInternalMemberUser API を使用して、外部ユーザーを内部メンバー ユーザーに変換する機能を追加しました。 この変換により、変換されたユーザーは、テナント内の内部メンバー ユーザーの完全な特権を取得しながら、既存のユーザー オブジェクトとアクセスを維持できます。
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 コミュニティ ページにアクセスして、開発者の呼び出しの完全な予定表を確認してください。
研究パネルに参加して、開発者エクスペリエンスに関するご意見をお知わせください。
関連コンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示