Microsoft Graph 入門

開発者のための Azure セキュリティ実装

Anushika Agarwal

Cloud Data Engineer

Microsoft Graph とは？

  • Microsoft 365 のデータにアクセスできる統合 API

  • すべてのサービス向け単一のエンドポイント

Microsoft Graph - すべてのサービス向け単一のエンドポイント

開発者のための Azure セキュリティ実装

例：Microsoft Graph を利用した PeopleSphere

  • PeopleSphere の利用例:

    • 休暇申請にOutlook
    • 人事ミーティングにTeams
    • 給与明細にOneDrive

  • Graph がこれらすべてを連携します

PeopleSphere による Microsoft Graph の活用方法

開発者のための Azure セキュリティ実装

Graph API 呼び出しの構造

統合 API：Microsoft Cloud サービスのリソースにアクセスする単一のエンドポイント Microsoft Graph API リクエスト

開発者のための Azure セキュリティ実装

リクエストの内訳

  • リクエストの構成要素:

    • メソッド: GET、POST、PATCH など

    • バージョン: v1.0、beta

    • リソース: users、groups など

    • クエリパラメータ: $select、$filter

    • ヘッダー: Authorization、Content-Type

Microsoft Graph API リクエスト

開発者のための Azure セキュリティ実装

メソッド

  • サポートされるメソッド:

    • GET: データを取得

    • POST: 新規データを作成

    • PUT: データを完全に置き換え

    • PATCH: 既存データを更新

    • DELETE: データを削除

開発者のための Azure セキュリティ実装

バージョン管理：v1.0

  • https://graph.microsoft.com/v1.0/groups

  • 安定版 API

  • 一般提供されている API
  • 本番環境のアプリで使用

バージョン管理 - v1.0

開発者のための Azure セキュリティ実装

バージョン管理：beta

beta

  • https://graph.microsoft.com/beta/groups
  • プレビューの実験的機能
  • 不安定で変更される可能性あり
  • テスト用のみで本番環境には非対応

`

バージョン管理 - Beta

開発者のための Azure セキュリティ実装

リソース

  • 操作対象となる特定のデータ。

  • 例:

    • Users: ユーザー情報にアクセス
      • /users、/me
    • Groups: グループを操作
      • /groups
    • Events: カレンダーイベントを取得
      • /users/{userId}/events

ユーザー

グループ

イベント

開発者のための Azure セキュリティ実装

クエリパラメータ

  • データのフィルタリング、並べ替え、選択を行うオプション

  • Select:

    • 特定のフィールドを選択
    • $select=id,displayName

  • Filter:

    • データを絞り込み
    • $filter=startswith(displayName, 'John')

  • Top:

    • 結果の件数を制限
    • $top=5

クエリパラメータ - Select

  クエリパラメータ - Filter

  クエリパラメータ - Top

開発者のための Azure セキュリティ実装

ヘッダー

HTTP のリクエストとレスポンスにメタデータを含めます

ヘッダーには標準と API 固有の2種類があります

ヘッダー

  • 標準: すべてのリクエストに共通
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • API 固有: API ごとに異なる
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
開発者のための Azure セキュリティ実装

練習しましょう！

開発者のための Azure セキュリティ実装

Preparing Video For Download...