Office関連

Microsoft Graph SDK for PHPを使ったAPIの呼び出しサンプル

知らない間に(恐らくBuild 2017のタイミングに合わせて)Microsoft Graph・PHP用SDKの安定版がリリースされていたので、さっそく試してみました。

テスト環境

  • Windows 7 Professional SP1 64-bit
  • XAMPP Portable Version: 5.6.30
  • PHP Version 5.6.30
  • Microsoft アカウント

アプリケーションIDとアプリケーションシークレットの取得

APIを呼び出すにあたり、まずはアプリケーションID(クライアントID)とアプリケーションシークレット(クライアントシークレット)の準備をします。

  1. v2.0エンドポイントを使用するため、Application Registration Portalにアクセスし、Microsoft アカウントでサインインします。
  2. アプリの追加」ボタンをクリックします。
  3. Register your application画面が表示されたら、アプリケーション名や連絡先を入力して、「Create」ボタンをクリックします。
  4. アプリケーションの登録画面が表示されたら、「アプリケーション ID」(クライアントID)をコピーしておきます。
  5. 新しいパスワードを生成」ボタンをクリックして、生成されたパスワードをコピーしておきます。このパスワードがアプリケーションシークレット(クライアントシークレット)となります。
  6. プラットフォームの追加」ボタンをクリックして、「Web」を追加します。
  7. リダイレクト URL」欄に認証後に飛ばされる先のURL(リダイレクトURL)を入力します。
  8. Microsoft Graph のアクセス許可」は一先ず「User.Read」だけにしておきます。必要に応じて、ここでスコープを追加します。
  9. 今回は「プロファイル」は空欄にしておきます。
  10. 保存」ボタンをクリックして、アプリケーションの設定を保存します。

以上でアプリケーションIDとアプリケーションシークレットの準備は完了です。

SDKとOAuth認証用ライブラリの準備

SDKを使ってAPIを呼び出すわけですが、GitHubを見ると下記のような記述があります。

The Microsoft Graph SDK for PHP does not include any default authentication implementations. Instead, you can authenticate with the library of your choice, or against the OAuth endpoint directly.

OAuth 2.0の認証部分に関してはSDKに含まれていないため、自力で実装するか適当なライブラリを使う必要があるようです。

今回は「Azure Active Directory v2.0 認証ライブラリ」でも紹介されている「PHP League oauth2-client」を使うことにします。

インストールは簡単で、「composer install」するだけです。
(必要に応じて、導入するバージョンを変更してください。)

{
    "require": {
        "league/oauth2-client": "~2.0",
        "microsoft/microsoft-graph": "1.0.*"
    }
}

特にエラーが発生しなければ、これでSDKの準備は完了です。

Microsoft Graph SDK for PHPによるAPIの呼び出し

準備が整ったので、次はいよいよコードを書いていきます。

※ コード内の「clientId」と「clientSecret」、「redirectUri」はそれぞれ、上記手順で取得したものに置き換えてください。

<?php
  require_once './vendor/autoload.php';
  use Microsoft\Graph\Graph;
  use Microsoft\Graph\Model;
  $accessToken = NULL;
  
  $provider = new \League\OAuth2\Client\Provider\GenericProvider([
    'clientId'                => '(アプリケーション ID)',
    'clientSecret'            => '(アプリケーション シークレット)',
    'redirectUri'             => '(リダイレクト URL)',
    'urlAuthorize'            => 'https://login.microsoftonline.com/common/oauth2/v2.0/authorize',
    'urlAccessToken'          => 'https://login.microsoftonline.com/common/oauth2/v2.0/token',
    'urlResourceOwnerDetails' => '',
    'scopes'                  => 'user.read'
  ]);
  
  //アクセストークン取得
  if($_SERVER['REQUEST_METHOD'] === 'GET' && !isset($_GET['code']) && !isset($_GET['error'])){
    $authorizationUrl = $provider->getAuthorizationUrl();
    header('Location: ' . $authorizationUrl);
    exit();
  }elseif($_SERVER['REQUEST_METHOD'] === 'GET' && isset($_GET['code'])){
    try{
      $accessTokenObj = $provider->getAccessToken('authorization_code', [
        'code' => $_GET['code']
      ]);
      $accessToken = $accessTokenObj->getToken();
    }catch(League\OAuth2\Client\Provider\Exception\IdentityProviderException $e){
      printf('Error:', $e->getMessage());
    }
  }
  
  //Graph API呼び出し
  if($accessToken){
    $graph = new Graph();
    $graph->setAccessToken($accessToken);
    
    $user = $graph->createRequest('GET', '/me')
              ->setReturnType(Model\User::class)
              ->execute();
    echo 'Hello, ' . $user->getDisplayName();
  }

上記コードのページを開くと、Microsoft アカウントのサインインページに飛ばされるので、サインインを行います。

コンセントUIが表示されるので、「はい」ボタンをクリックして、アクセスを許可します。

APIの呼び出しが無事に行われれば、ユーザー名が表示されます。

おわりに

今回初めてMicrosoft GraphのPHP用SDKとOAuth認証用ライブラリを使ってみましたが、驚くほど簡単にAPIを呼び出せました。

VBAから無理やり呼んだときとは雲泥の差です。

やはり専用に用意されたSDKは便利ですね!
管理も非常に楽になるし、Microsoft Graphを使ったWebアプリケーションを開発される方は、SDKの利用を強くお薦めいたします。

関連記事

  1. アイコン一覧

    Office 2013 アイコン一覧(D)

    ・Office 2013 アイコン一覧 NUM…

  2. Office アドイン

    [Office用アプリ]マニフェストファイルで多言語対応させる。

    Office用アプリの各種設定を定義するXMLマニフェストファイルです…

  3. Windows 10

    SeleniumBasic(Selenium VBA)がMicrosoft Edgeに対応しました。…

    言わずと知れたWebブラウザーの自動制御ツール「Selenium」のV…

  4. Windows 10

    【2017年1月版】Microsoft Edgeを操作するVBAマクロ(DOM編)

    「Microsoft Edge VBA 操作」こういったキーワード検索…

  5. Office関連

    [Excel Services ECMAScript]ループによる入力と一括入力の処理時間について

    埋め込んだExcelワークブックのセルに対して、ループで1セルずつ入力…

  6. Office アドイン

    [Office用アプリ]Bing Maps for Accessの紹介

    Microsoft Download CenterでAccess向けO…

コメント

  • コメント (0)

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

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

Time limit is exhausted. Please reload CAPTCHA.

最近の記事

アーカイブ

RapidSSL_SEAL-90x50
PAGE TOP