デスクワークを超絶快適にするおすすめギアたち

【2021年版】Microsoft Graph Explorerを触ってみよう!

【当サイトはプロモーションを含んでいます】

じょじお

Microsoft Graph Explorerをざっくりと解説する記事です。

目次

Microsoft Graphとは?

Microsoft Graphとは?
Microsoft 365に含まれるサービスを操作するために公開されているREST APIです。

Microsoft Graph は、Microsoft 365 のデータとインテリジェンスへの入り口です。 Microsoft Graph は、Microsoft 365、Windows 10、および Enterprise Mobility + Security の膨大な量のデータにアクセスする際に使用できる統合型プログラミング モデルを提供します。 Microsoft Graph の豊富なデータを使用して、数百万人のユーザーを操作する組織やコンシューマー向けのアプリを作成できます。

引用: https://docs.microsoft.com/ja-jp/graph/overview
じょじお

APIは基本的には開発者が触るものですね。

ぽこがみさま

ExcelやSharepoint、TeamsなんかもMicrosoft Graphから操作することができるにゃ。

Microsoft Graph Explorerとは?

Microsoft Graph Explorerはと?
Microsoft GraphをGUIで操作できるMicrosoftのWebツールです。

Graphエクスプローラーは開発者向けツールで、MICROSOFT の REST API 要求を簡単にGraph対応する応答を表示できます。 Graph エクスプローラーを使用して、既定のサンプル テナントで API を試して機能を探索するか、独自のテナントにサインインし、それをプロトタイプ ツールとして使用してアプリのシナリオを満たします。

引用:https://docs.microsoft.com/ja-jp/graph/graph-explorer/graph-explorer-overview
じょじお

Microsoft Graph Explorerは、Microsoft GraphをGUIで操作できるツールです。

ぽこがみさま

事前に用意されているSample Queryを使えば知識がなくても簡単に試すことができるにゃ。

Microsoft Graphでできることは?

詳細はMicrosoftのドキュメントをご確認ください。

Microsoft Graph Explorerを触ってみよう!

じょじお

自分が所属するグループの情報を取得しながら、操作方法や画面の見方について解説します。

STEP
Microsoft Graph Explorerを開きます。
Microsoft Graph Explorer

Microsoft Graph Explorerはこちら。

STEP
Graph Explorerにサインインします。
じょじお

デフォルトの未ログインの状態ではサンプルデータしか操作することしかできません。自分の環境にサインインしましょう。

Microsoft Graph Explorer

▲左側メニューの「Sign in to Graph Explorer」をクリックします。

Microsoft Graph Explorer

▲ご自身のMicrosoft 365の認証情報を入力して「Sign in」をクリックします。

STEP
サンプルクエリを選択します。
じょじお

Graph Explorerには事前によく使うクエリがサンプルクエリとして用意されています。自分の所属するMicrosoftグープを取得できるクエリを使ってみたいと思います。

Microsoft Graph Explorer

▲左側メニューの①Sample Queriesをクリックして、Groupセクションの中にある②「 All groups in my organization 」というクエリを選択します。

STEP
アクセス許可の設定を行います。(Modify Permissions)
じょじお

クエリを送信する前に権限の許可を設定しなければなりません。

Microsoft Graph Explorer

▲画面の真ん中あたりにある、「Modify Permissions」というタブをクリックします。

Microsoft Graph Explorer

▲選択したクエリに必要な権限(Permissions)が一覧されます。右側にある「Consent」(承諾)というボタンをひとつずつクリックしていき許可を与えていきます。

Microsoft Graph Explorer

▲Accept(許可)をクリックします。

Microsoft Graph Explorer

▲すべての項目のStatusが「Consented」と表示されていればOKです。

STEP
クエリを発行します。
じょじお

準備が整いましたのでクエリを発行してみましょう。

Microsoft Graph Explorer

画面の上部にあります「Run Query」ボタンをクリックします。

(発行するクエリは「https://graph.microsoft.com/v1.0/groups」となっているかと思います。)

STEP
クエリの結果を確認します。
じょじお

クエリの結果を確認してみましょう。

Microsoft Graph Explorer

▲Graph Explorerの下の方のペインの「Response Preview」タブをクリックするとクエリの結果が表示されます。

Microsoft Graph Explorer

▲Expandをクリックすると大きく表示することができます。

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups",
    "value": [
        {
            "id": "2ab0c96d-71b8-4fb8-81c9-************",
            "deletedDateTime": null,
            "classification": null,
            "createdDateTime": "2021-10-21T06:10:37Z",
            "creationOptions": [],
            "description": null,
            "displayName": "配布グループA",
            "expirationDateTime": null,
            "groupTypes": [],
            "isAssignableToRole": null,
            "mail": "haihu_A@tejilabo.onmicrosoft.com",
            "mailEnabled": true,
            "mailNickname": "haihu_A",
            "membershipRule": null,
            "membershipRuleProcessingState": null,
            "onPremisesDomainName": null,
            "onPremisesLastSyncDateTime": null,
            "onPremisesNetBiosName": null,
            "onPremisesSamAccountName": null,
            "onPremisesSecurityIdentifier": null,
            "onPremisesSyncEnabled": null,
            "preferredDataLocation": null,
            "preferredLanguage": null,

以下省略
じょじお

出力されたJSONをみてみると、私の所属する「配布グループA」というグループやその他のグループの情報をみることができました。

グループ情報の中の”id”は、Power AutomateのAzure ADコネクタで必要になるので、確認の方法のひとつとして覚えておくと良いかなと思います。

Graph Explorerの 403エラー

Microsoft Graph Explorer

Permissionの許可ができていないと「403エラー」が発生します。このエラーが表示されたときはアクセス許可の設定を確認してみてください。

Graph Explorerのアクセス許可

クエリによって必要なPermissionは異なります。別のクエリを発行する際には、都度Permissionの設定を確認して不足しているものがあれば許可してください。

Graph APIドキュメント

それぞれのキーが何を意味するかについてはドキュメントをご確認ください。

まとめ

じょじお

以上、Graph Explorerの使い方について解説しました。

ぽこがみさま

他にも色々なサンプルクエリがあるので試してみてにゃ。

お役に立てたらシェアお願いします!
  • URLをコピーしました!
  • URLをコピーしました!
目次