Office関連

Office365APIEditorでMicrosoft Graph APIを手軽に呼び出し!

下記Tech Communityの記事で、Microsoftのエンジニアである小間さんが公開されているツール「Office365APIEditor」のことを知ったので、さっそく試してみました。

Office365APIEditorのインストール方法

GitHubのReleasesページを開くと、インストーラー(msi)をダウンロードすることができます。zip版も用意されているので、お好きな方をダウンロードしてください。
(私は手軽なzip版を使用しています。)

アプリケーション IDの取得

APIを呼び出すにあたり、まずはアプリケーションID(クライアントID)を準備します。
今回はMicrosoft アカウントを使用します。

  1. Application Registration Portal(https://apps.dev.microsoft.com/)にアクセスし、Microsoft アカウントでサインインします。
  2. 2019年6月時点では、Azure Portalを使うことを勧められるので、指示に従ってAzure Portalを開きます。
  3. アプリの登録」画面が表示されます。Azure Portal → Azure Active Directory → App registrations からも同じ画面を表示できます。
  4. 新規登録」ボタンをクリックします。
  5. 名前、サポートされているアカウントの種類(任意の組織のディレクトリ内のアカウントと、個人用の Microsoft アカウント (Skype、Xbox、Outlook.com など))、リダイレクト URI(パブリック クライアント (モバイルとデスクトップ))を入力し、「登録」ボタンをクリックします。
  6. 問題が無ければ、アプリケーションの作成が行われます。
  7. アプリケーションID(クライアントID)が後で必要になるので、クリップボードにコピーし、メモ帳等のテキストエディタに貼り付けておきます。
  8. API のアクセス許可」を開き、必要に応じてアクセス許可を設定します。今回は「User.Read」、「Mail.ReadWrite」、「Mail.Send」を追加します。

以上でアプリケーションIDの取得作業は終了です。

メールボックスビューアモード

メールボックスビューアモードでは、Outlook REST APIを使用して、フォルダやアイテムなどのメールボックスの内容を参照できます。

  1. File」メニューから「New Session…」をクリックします。
  2. Application ID Settingダイアログが表示されたら、「Application ID : 」にコピーしておいたアプリケーションIDを貼り付け、「Use the built-in application」ボタンをクリックします。
  3. 「アカウントにサインイン」画面が表示されるので、使用するアカウントでサインインします。
  4. 「このアプリがあなたの情報にアクセスすることを許可しますか?」画面が表示されたら、「はい」ボタンをクリックします。
  5. 認証が成功すると、左ペインに「Calendar Folders」「Task Groups」「MsgFolderRoot」ツリーが表示され、選択内容は右ペインに表示されます。
  6. Windows」メニューから「New Message…」をクリックすると、メールの新規作成画面が表示されます。
  7. 宛先や件名、本文等を入力し、「Send」ボタンをクリックすると、Outlook REST APIを使用してメール送信されます。

エディタモード

エディタモードでは、Microsoft GraphなどのAPIの呼び出しが行えます。
Microsoft Graphだけでなく、Outlook REST APIやOffice 365 マネージメント アクティビティ API(Office 365 Management Activity API)もサポートされています。

  1. Tools」メニューから「New Editor…」をクリックします。
  2. エディタ画面が表示されるので、「File」メニューから「New Access Token…」をクリックします。
  3. 「I have not registered the application. Office365APIEditor will use the built-in application or basic auth.」を選択し、「Next」ボタンをクリックします。
  4. 「Office365APIEditor built-in application」を選択し、「Next」ボタンをクリックします。
  5. スコープの入力画面が表示されるので、「Scope editor…」ボタンをクリックして、必要なスコープを選択します。「Select default values」ボタンをクリックすると、使用頻度の高い一般的なスコープが選択されますが、今回は「https://graph.microsoft.com/User.Read」のみを選択します。
  6. 「アカウントにサインイン」画面が表示されるので、使用するアカウントでサインインします。
  7. 認証が成功すると、エディタモード画面に戻ります。
  8. Example」タブのツリーには、主要なサンプルリクエストが並びます。
  9. リクエストを選択して「Run」ボタンをクリックすると、APIの呼び出しが行われ、結果が下ウィンドウに表示されます。今回は「https://graph.microsoft.com/v1.0/me」を実行しましたが、問題なくユーザー情報を取得できました。
  10. エディタ画面では、リクエスト本文やヘッダー、メソッド等を指定できるので、サンプルを参考に、自由にAPIをテストすることができます。

以上でOffice365APIEditorの簡単な機能説明は終了です。
機能の詳細はTech Communityの記事や下記動画をご参照ください。

また、Office365APIEditorには、ユーザー設定のリセットや呼び出し履歴の削除等を行うコマンドラインスイッチも用意されており、GitHubに説明が記載されています。

上記の通りOffice365APIEditorを触ってみましたが、ザックリ言ってしまうと、

“オフラインで使える超手軽なGraph エクスプローラー”

といった感じです。
バージョン番号からするとまだベータ版のようですが、Graph APIを分かっていれば直感的に扱えて、非常に使いやすいツールです。

Office 365開発を行う人は、手元に置いて損は無いツールですので、是非一度お試しください!

【2019年6月版】Excel カスタム関数(Excel Custom functions)の紹介前のページ

Microsoft Update カタログから累積更新プログラムをダウンロードするVBScript次のページ

関連記事

  1. アイコン一覧

    Office 2013 アイコン一覧(J)

    ・Office 2013 アイコン一覧 NUM…

  2. Office関連

    [雑感]Office 365 Soloに向く人、向かない人

    ここ一週間ほどOffice 365 Soloを触ってみて、ある程度のこ…

  3. Office関連

    Trello APIを使ってカードを投稿するVBAマクロ

    以前Fiddlerを使ってTrello APIを実行する記事を書きまし…

  4. Office関連

    [リボン・カスタマイズ]splitButton要素で大量にある項目を使いやすくまとめる。

    「既存の機能の代わりにマクロを実行する」でコメント(下記)をいただきま…

  5. Office関連

    Visio Onlineで図の作成・編集ができるようになりました。

    しばらくVisio Onlineを使っていなかったので気が付かなかった…

  6. Office アドイン

    [Office用アプリ]仕事の息抜きにピッタリ「もぐらミニ」

    KumaP氏作の作業ウィンドウアプリ「もぐらミニ」がOffice スト…

コメント

  • コメント (0)

  • トラックバックは利用できません。

  1. この記事へのコメントはありません。

Time limit is exhausted. Please reload CAPTCHA.

※本ページはプロモーションが含まれています。

Translate

最近の記事

アーカイブ

PAGE TOP