開発者向けMicrosoft Graph

Build 2017で発表されたMicrosoft Graphの新機能を使用すると、さまざまなデバイス上のアプリケーションでの作業の同期は言うまでもなく、人々、会話、プロジェクト、コンテンツの間でさらに興味深い関係を確立できます。 そのため、このツールについて詳しく説明し、開発者向けの新しいAPIと機能に関する記事を翻訳することにしました。 「オフィス」開発者、猫へようこそ。 :)







Build 2017カンファレンスで、Microsoftは、ビジネスアプリケーションとビジネスプロセスの開発者に提供されるツールボックスの機能を大幅に拡張する新しいAPIとMicrosoft Graph関数を導入しました。



Microsoft Graphは、コラボレーションと情報交換をサポートしながら、さまざまなエンティティ(ユーザー、操作、さまざまなデバイス間)間の対話を提供します。 Microsoft Graphには、会社に関する運用分析データを提供する機能もあります。







以下では、「新しい高度なデータセットに基づくアプリケーション開発」、「新しいプラットフォーム機能をサポートする強力なアプリケーションの開発」、および「簡素化された開発者インターフェイスを使用したシンプルで便利なアプリケーション開発」の3つの主要トピックに重点を置いて、Microsoft Graphの新機能を詳細に検討します。



新しい高度なデータセットに基づいたアプリケーション開発



Microsoft Graphで使用できるデータセットの数は増え続けています。 開発者はこれらの追加のデータセットを使用して、新しいAPIを使用してスマートアプリケーションを開発できます。



SharePointサイトAPIがMicrosoft Graph v1.0エンドポイントと統合されました



前に、Microsoft Graphエンドポイントのベータ版でSharePointサイトを使用する可能性を紹介しました。 ユーザー、組織、およびアプリケーションに必要なSharePointサイトのメタデータとリンクのセットを検出できる機能が、実稼働で使用できるようになりました。



詳細はこちらを ご覧ください



Planner APIがMicrosoft Graph v1.0エンドポイントと統合されました



Planner APIを使用すると、アプリケーションはタスクを作成し、Office 365のグループ内のユーザーに割り当てることができます。複数のユーザーにタスクを割り当てるための発表されたサポートに加えて、新しいセグメント/スケジューラー/すべてのスケジューラーリソース、orderHintプロパティを指定するための新しいスキームなど、多数の更新も提供されます。



詳細については、 API Plannerのドキュメントと、dev.office.com / build-videosのスケジューラAPIに関するエンジニアリングチームのErayビデオを参照してください。



OneNote APIがMicrosoft Graph v1.0エンドポイントと統合されました



OneNote APIは、生産とOneNoteとの統合に使用できるようになりました。これらは、OneDrive for usersおよびOneDrive for businessに保存されています。 新機能:



Azure AD v2.0での認証サポート 。 Azure Active Directory(Azure AD)v2.0の認証用の新しいエンドポイントサポート機能により、個人、職場、および学校の​​アカウントのユーザーがMicrosoft GraphエンドポイントでOneNote APIを使用できるようになります。

ユーザーとグループのメモ帳 。 Microsoft Graph APIを介したすべてのOneNoteサービス呼び出しは、サービスの次のルートURLを使用します。



https://graph.microsoft.com/v1.0/{location}/onenote/
      
      





消費者向けOneDriveおよびOffice 365(さまざまなOffice 365およびビジネスグループ向けOneDrive)のユーザーノートブックを指すことができます。 SharePointサイトでホストされるノートブックのサポートは、次のリリースで計画されています。



詳細については、 OneNoteのヘルプドキュメントとエンジニアリングチームのOneNote API Team Manjushiのビデオを参照してください。



Microsoft Teams APIがMicrosoft Graphエンドポイントベータに統合されました



Microsoft Teamsは、チャットベースの新しいOffice 365ワークスペースです。 これまで、Microsoft GraphのGroups APIの拡張機能を使用して、Microsoft Teamsとの統合が可能です。 アプリケーションは、ユーザーが属するグループを判別し、このグループ内のチャンネルを一覧表示するか、新しいチャンネルを作成し、ユーザーに代わって新しいチャットメッセージを送信します。 ワンクリックでインシデントの現在のステータスをグループに通知できるインシデント管理アプリケーションを想像してください。 さらに、既存のほとんどのグループAPI(ファイル、注釈、プランインターフェイスなど)もMicrosoft Teamsで使用できます。 これは、グループチャットメッセージおよびAPIを介して動的に更新されるデータへのアクセスを強化するための最初のステップにすぎません。



詳細については、 グループとチームのドキュメントを参照してください。



Microsoft Graphエンドポイントベータ版の新しいInsight API



Microsoft GraphのInsight APIは、ユーザーアクションに基づいてリアルタイムの分析データを提供します。 たとえば、Trending APIを使用して一般的なドキュメントを取得したり、People APIを使用してユーザーのコラボレーションデータを取得したりできます。 2017年5月末に、使用済みAPIと共有APIの2つの新しいInsight APIを追加する予定です。



Used APIは、社内のユーザーが作業したドキュメントのうち、将来的に戻ってくる可能性が最も高いドキュメントを返します。 これは、ユーザーが表示または編集した最も人気のあるドキュメントにアクセスする便利な方法です。 これらのドキュメントには、OneDrive for BusinessおよびSharePointで使用されるドキュメントが含まれます。



共有APIを使用すると、ユーザーは、他のユーザーまたは特定のユーザーによって共有されている最もリクエストの多いドキュメントに戻ることができます。 このAPIは、電子メール、会議の添付ファイル、OneDrive for Business、SharePoint、およびBox、DropBox、Google Driveなどのサービスプロバイダーからの最新の添付ファイルを介して共有されるファイルを組み合わせます。



詳細については、WebページのMicrosoft GraphのInsight APIに関するエンジニアリングチームのマリオビデオを参照してください。



Microsoft Graph Endpoints Betaの更新されたSharePointリストAPI



組織は、SharePointを使用して、サイト、ミッションクリティカルなドキュメント、およびその他のデジタルリソースをホストできます。 SharePointリストのベータ版のMicrosoft Graphエンドポイント更新API。 これらのAPIを使用すると、ユーザーと組織に関連する一連のSharePointリストを操作できます。



基本的なシナリオのセットに加えて、リストへのアクセス、リストリソース、およびlistItemsおよびdriveItems属性の書き換えもサポートされています。 プレビューバージョンも更新されました。これには、SharePointリストのリスト、コンテンツタイプ、およびサイト列を作成できる新しい機能が含まれています。



詳細は こちらをご覧ください



Microsoft Graphエンドポイントベータ版のOffice 365レポートAPI



1年を通して、IT管理者にユーザーがOffice 365を展開および使用する方法に関する運用分析データを提供しました。MicrosoftGraphでレポートを作成するための新しいAPIセットを準備しました。これはすべてのユーザーがプレビューできます。 APIのおかげで、ユーザーは使用状況レポートデータにプログラムでアクセスし、既存のレポートソリューションに統合できます。



ユーザーは17の個別のレポートを使用できます。 これらのレポートは、Office 365コア製品(電子メール、SharePoint、Skype for Business、Yammer)またはOffice 365ソリューション自体(アクティブユーザー、アクティベーション)の使用を反映しています。 Microsoft Graphは、選択したレポートの種類ごとにCSVファイルを作成します。



詳細について、ブログのレポートに関するAPIのお知らせとAPIレポートのドキュメントをご覧ください。



他の製品のMicrosoft Graph:Intuneおよびその他のAPI



Microsoft Graphは絶えず改善および開発されており、Officeソリューションだけでなく、他の製品を対象とする新しい高度なデータセットが追加されています。



Intune API(ベータ版を更新) エンドポイントのベータ版で利用可能なIntune APIは、ユーザー、デバイス、アプリケーションなどの組織のリソースを管理するための新しいツールを提供します。



Active Directoryを管理するためのAPI 。 このインターフェイスセットには、管理ユニット、ドメイン、ポリシー、およびライセンスを含む開発ツールが含まれています。



デバイスと操作のリモート使用のためのAPI 。 デバイスとプラットフォーム間の相互作用を提供し、ユーザーがデスクトップPC、Xbox、IoT、HoloLensデバイス、そしてもちろん、デバイスと操作を管理するための新しいAPIを使用してWindows、Android、iOSを実行するスマートフォンでインターフェースをリモートで使用できるようにするインターフェースの開発、 Project Rom eによって開発されました。



新しいプラットフォーム機能をサポートする強力なアプリケーションの開発



Microsoft Graphプラットフォームに機能の更新を導入しました。これにより、強力なアプリケーションをさまざまな方法で開発できます。 この機能を使用すると、Microsoft Graphデータセットの変更またはこれらのデータセットの拡張機能を検出し、迅速に処理できるさらに強力なソリューションを開発できます。



デルタリクエスト



クラウドの変更に応じたアプリケーションのデータ同期は、デルタクエリを使用して実現できます。デルタクエリは、エンドポイントv1.0で利用可能になり、完全に機能します。



デルタクエリを使用すると、アプリケーションは、Azure Active Directory(Azure AD)およびOutlookの各リクエストでリソースの完全な読み取りを実行することなく、新しいオブジェクト、更新されたオブジェクト、または削除されたオブジェクトを検出できます。 これで、 ユーザー、グループ、メッセージ、メールフォルダー、カレンダーイベント、個人の連絡先、連絡先フォルダー、およびディスクセクションの変更を検出できます。 ローカルデータストアを使用するアプリケーションは、デルタクエリを使用して、Microsoft Graphとデータを効率的に同期できます。 ローカルデータストアを使用しないステートレスアプリケーションは、デルタクエリを効率的に使用して、必要なリソースで簡単な変更追跡操作を実行することもできます。



次に、最初のGETデルタリクエストをOutlook calendarViewアドレスに送信する例を見てみましょう。



 GET me/calendarView/delta?startDateTime={start_datetime}&endDateTime={end_datetime}
      
      





GET要求は、nextLinkまたはdeltaLinkオブジェクト(デルタ関数呼び出しとステータストークンを含むURLを含む)を返します。



詳細については、デルタリクエストの一般的なドキュメントをご覧ください。また、エンジニアリングチームのJeffビデオご覧ください



新しいWebフック



Microsoft Graph APIの新しいWebフック。 クライアントアプリケーションには、メッセージ、イベント、連絡先、グループ会話、ルートディスクアイテムなど、一部のリソースの変更を通知するサブスクリプションが既にあります。 本日、ユーザーおよびグループ向けのAzure ADの新しいサブスクリプションオプションと、Outlook.comリソースの追加サポート機能を準備しました。 これにより、企業は主要なプロセスを作成して、新しいユーザーをサポートし、プロファイルを更新できます。



詳細については、当社のWebサイトで提供されているWebフックのドキュメントとサンプルコードを参照してください。 Node.jsおよびASP.Netを使用する開発者向けのMicrosoft Graph Webスニファーコードサンプルおよび関連ドキュメントは、GitHubポータルで入手できます。 弊社のエンジニアの1人であるジェフがWebフックとデルタリクエストについて語っているビデオを必ずチェックしてください。



Microsoft Graphでユーザーデータをサポートするための拡張機能



これで、Microsoft Graphで独自のユーザーデータを使用できます。 この機能は実稼働で使用する準備ができています。 独自のユーザーデータ(たとえば、セキュリティプロファイル/アクセスレベルを機密情報に追加したり、ユーザープロファイルデータの専門的な認定)をMicrosoft Graphの情報に接続できます。 Microsoft Graphでは、外部データストアを使用せずに、拡張機能を作成し、リソースにカスタムプロパティを追加できます。



2種類の拡張機能が利用可能です。





追加情報とコード例を提供するブログ詳細を確認できます。また、当社のエンジニアの1人であるDanのビデオもご覧ください。



バッチ処理によりアプリケーションのパフォーマンスを最適化する



バッチJSON要求を使用して、ユーザーは1つのHTTP呼び出しでMicrosoft Graphへの複数の要求を組み合わせることができます。



JSONバッチリクエストは常にPOSTを介してエンドポイント/ $ BATCHに送信されます。 JSONバッチ処理リクエストテキストは単一のJSONオブジェクトであり、リクエストプロパティの設定が必要です。 この場合のリクエストプロパティには、URLの識別子、メソッド、プロパティに加えて、個々の必要なリクエストの配列が含まれます。 標準のJSONバッチリクエストに加えて、 atomicityGroupプロパティを使用したリクエストのグループ化のサポートも実装されています。 バッチ処理リクエストは、シーケンシャルまたは非同期の場合があり、URLの長さの制限を回避するためにも使用できます。 もちろん、そのようなクエリ関数には多くの制限があります。



追加情報 。 詳細なバッチ処理のドキュメントは、今後数週間にわたってgraph.microsoft.comで公開されます。



シンプルな開発者インターフェースを使用したシンプルで便利なアプリケーション開発



開発者インターフェイスの改善を続けています。 Buildカンファレンスでは、さまざまな言語とプラットフォームを使用する開発者向けに、Microsoft Graphとの作業を改善するために設計された多くの拡張機能を紹介しました。



Microsoft認証ライブラリ(MSAL)の新規および更新されたプレビュー



iOSAndroid、およびJavaScript のMicrosoft認証ライブラリ(MSAL)のプレビューバージョンおよび.NETプラットフォーム用のMSALの更新されたプレビューバージョンをご紹介します。 MSALは、Microsoftの個人アカウント、およびMicrosoft Graphを呼び出すときのAzure ADの仕事用アカウントと学校用アカウントに対して、シンプルで便利な認証を提供します。 プレビュー版でも、これらのライブラリは本番環境での使用が完全にサポートされています。



詳細については、MSALおよびAzure AD v2.0エンドポイントに関するセクションを参照してください。



開発者インターフェイスの強化



Graph Explorerの更新を展開しました。これには、機能を拡張する新しいインターフェイス要素が含まれています。 グラフエクスプローラーのユーザーは、事前に構成された要求パターンの使用、要求ヘッダーの設定、メッセージテキストテンプレートの使用などができるようになりました。







グラフエクスプローラーの使用が簡単になりました。 手順の数を減らしてクイックスタートガイドを更新し、いくつかのシナリオがどのように機能するかを示すより意味のある例を提供しました。



また、SDKを大幅に改善し、ドキュメントを補足しました。 .NETおよびAndroidプラットフォーム用の更新されたSDKと、JavaScriptおよびPHP用の完全に機能するMicrosoft Graph SDKを導入しました。 DanとCaitlin(それぞれJavaScriptとPHPのスペシャリスト)がSDKをどのように改善したかについて語っているビデオをご覧ください



Visual StudioはConnected Servicesインターフェイスを更新しました。ここで、プロジェクトをカスタマイズし、数回クリックするだけでアプリケーションを登録できます。 詳細こちら



開発者コミュニティには境界がありません。そのため、Microsoft Graph開発者ポータルの資料のローカライズに引き続き取り組んでいます。 資料は9つの言語で利用可能です。 現在、資料は英語、ドイツ語、日本語、中国語(簡体字)言語だけでなく、フランス語、ポルトガル語、スペイン語、ロシア語でも利用できます。



詳細については、 ブログ 、新しいSDKの資料、 フランス語ロシア語 、およびその他の言語のWebサイトを参照してください。



直接またはインターネット経由で参加したBuildカンファレンスのすべての参加者に、時間をかけてブログを理解していただきありがとうございます。 ここで説明したMicrosoft Graphの機能(新しいデータセット、高度なプラットフォームツール、改良された開発者インターフェイス)が、高度な接続機能を備えたより強力でインテリジェントなアプリケーションの開発に役立つことを願っています。 Microsoft Graphの使用に関するフィードバックをお待ちしております。お客様のご意見は非常に重要です。 #MicrosoftGraphタグを使用してTwitterチャンネルのニュースをフォローし、StackOverflow Webサイトに質問を送信して、#MicrosoftGraphでタグ付けします。 プログラミングで頑張ってください!



All Articles