Graph APIを使った開発をする上で参考になったリンク集 - Baby step

目的

Microsoft系のサービスは種類が多く、また似た用語も多いです。それゆえ検索しても関連しない記事がヒットすることも...

今回は Graph API開発に関連しそうなリンクをまとめました。

なお、用語の予習をしたいという方はこちらも併せてご覧ください。

ドキュメントのルートです。ページ数が膨大なので、ここを目次代わりに眺めると良さそうです。

アプリの移行計画チェックリスト - Microsoft Graph | Microsoft Docs

初めて検索した時「Microsoft Graph」と「Azure AD Graph」の両方がヒットして、なんのこっちゃとなった思い出があります^^

Azure AD Graphは開発が終了しており、Microsoft Graphに移行するように言われています。

Graph APIを利用して開発する際のチュートリアルです。サーバー、ネイティブアプリ、シングルページアプリケーションごとにいくつかの言語でチュートリアルができます。

わたしはRubyのチュートリアルを試しました。 ※ 先述のサイト内にある「Ruby」をクリックしたものと同じです。

といった内容が解説されています。

サインインをすることで、ユーザーやアプリの登録など、AzureADの操作ができます。

チュートリアルで一度アクセスするのですが、それゆえ(?)検索キーワードを度々忘れて迷子になっていました。「azure portal」でググると出てきます。

利用可能なAPIは膨大です。どんなAPIがあるか、利用するためにどのような権限が必要か、を眺めておくといいでしょう。

アプリには、ユーザー個々人が認証を行い、自分のカレンダーなどにアクセスするものだけでなく、組織単位で認証を行い、テナント全体に対してAPI操作を行うものもあります。

なお、テナント単位で権限が必要なAPIを利用する場合、グローバル管理者の権限が必要です。

※ 権限が不要なAPIを利用する場合、クラウドアプリケーション管理者の権限で十分です。

ステータスコードとその説明が書かれています。一部の詳細な例外についても触れられています。

Azureが発行するトークンの種類が載っています。トークンことの有効期間一覧も載っています。

先日調査しましたが、開発者側からアクセストークンの有効期限を変更するのは大変そうでした...。

やや細部の話ですが、AzureADに登録するユーザーには「メンバー」「ゲスト」の2タイプがあります。ゲストの場合は、できる操作が制限されます。

テナント外のユーザーを招待する場合は基本的にゲストとなります。 ※ 設定すれば変更できるようですが