Microsoft Graphを使ってみた

目的

• Office 365 の操作を自動化したい。そのためのスパイク

今回のゴール

• API(Microsoft Graph)を使って、Plannerのタスク一覧を取得する

やったこと

1. Graph Explorer - Microsoft Graph にサインインする
2. 権限を付与する
   • 今回はタスク一覧を取得するのがゴールだったので Group.Read.All を付与した
   • 権限付与は管理者に承諾してもらう必要がある
   • Microsoft Graph のアクセス許可のリファレンス - Microsoft Graph | Microsoft Docs
3. APIを実行

試したAPI

• GET my profile 自身の情報を取得する
  • https://graph.microsoft.com/v1.0/me/
• GET all groups I belong to 自身が所属するグループを取得する
  • https://graph.microsoft.com/v1.0/me/memberOf
  • ここで言うグループはMicrosoft Teamsのチームと同じっぽい
• GET all Planner plans associated with a group グループに関連付いているPlannerのプランを一覧取得する
  • https://graph.microsoft.com/v1.0/groups/{group-id-with-plan}/planner/plans
  • group-id-with-plan にグループの id を指定する
• GET all Planner tasks for a plan プラン内のタスクを一覧取得する
  • https://graph.microsoft.com/v1.0/planner/plans/{plan-id}/tasks
  • plan-id にプランの id を指定する
  • これでプラン内のタスクが一覧取得できる
    • percentComplete : 進捗状況。 100 なら完了
    • appliedCategories: ラベル。1つ目のラベルが設定されていると "category1": true になる
    • assignments: 担当者。権限が足りてないせいか、名前が null になってた
    • GET https://graph.microsoft.com/v1.0/planner/tasks/{task-id}/details を使わないとチェックリストは取得できなさそう