こんにちは
any 株式会社でプロダクトチームに所属しているエンジニアの @se_yoshida です
この記事は、any Product Team Advent Calendar2024 17日目の記事になります。
この記事ではMicrosoft Teamsとの連携サービスの調査の過程で使用した、Microsoft Graph エクスプローラーについて紹介したいと思います！
Qastでは、Microsoft Teamsとの連携を活用することで、投稿の通知を受け取ったり、Teamsから直接Qastに質問やメモを投稿することができます。
詳しい機能についてはこちらをご覧ください。
TeamsからQastへの投稿機能
Teamsと連携する
[Qast]
[Microsoft Teams]
Microsoft Graph APIとGraph エクスプローラー
Microsoft Teamsとプロダクトの連携を実現するために Microsoft Graph API を活用します。
この API を使うと、Microsoft 365のデータやサービス（ユーザー、Teamsのチャネル、メッセージなど）にアクセスできます。
直接操作するためにクエリの構築や認証トークンの設定が必要など、APIの挙動を確認しながら開発するのはなかなか大変で、そのときに役立ったのが、Microsoft Graph エクスプローラーという公式ツールでした。
公式サイトはこちら: Microsoft Graph エクスプローラー
Microsoft Graph エクスプローラーの特徴
このツールの主な魅力は以下の点にあります。
-
ブラウザで試せる手軽さ
コードを書かずにGraph APIを実行し、リクエストとレスポンスをブラウザで簡単に確認できます。
-
Microsoft アカウント事前ログインで認証が楽になる
自身のアカウントで事前にログインしておくことで、毎回アクセストークンを取得する必要がなくなります。トークンによるログインでも可能なことですがログインすることで以下のような操作も可能となります。- 自身が所属しているTeamsのチャネル一覧の取得
- チャネル内のメッセージ取得
- 自身のプロファイル情報の取得
- リアルデータを使った実践的なテスト
-
サンプルクエリが豊富
よく使うAPIクエリがあらかじめ用意されており、それを少し変更するだけで自分のニーズに合ったリクエストを試せます。そのため、初めてGraph APIを触る場合でも学習コストが軽減されます。
特にMicrosoft アカウントログインで都度トークン取得しなくて済んだのは本当に楽でした！
こちらはサンプルにある「自分」という項目でAPIを叩くと、ログイン中のアカウントの「自分」に関するデータを取得できます。
実際に使ってみた感想
サンプルクエリが豊富で API の挙動を理解しやすかったです！
また、ログインしてリアルデータを扱えたこと、ブラウザ上でエラーが視覚的に確認できることも便利でした。
これからGraph APIを利用する方には、ぜひGraph エクスプローラーを試していただきたいです
any株式会社ではナレッジ経営クラウドQastのエンジニアを絶賛募集中です。
是非採用ページをご覧ください！
興味がある方は、こちらよりご応募お待ちしております。
エンジニア組織/文化について詳しく知りたい方はこちら。