Microsoft Graph を使って Java アプリを構築する

[アーティクル]
Developer (初級)
完了まで 28 分

このチュートリアルでは、Microsoft Graph API を使用してユーザーの代わりにデータにアクセスする Java コンソールアプリを構築する方法について説明します。

注:

Microsoft Graph を使用してアプリ専用認証を使用してデータにアクセスする方法については、このアプリ専用認証チュートリアルを参照してください。

このチュートリアルの内容:

ヒント

このチュートリアルに従う代わりに、アプリの登録と構成を自動化するクイックスタートツールを使用して、完成したコードをダウンロードできます。ダウンロードしたコードは、変更を加えずに機能します。

GitHub リポジトリをダウンロードまたは複製し、README の指示に従ってアプリケーションを登録し、プロジェクトを構成することもできます。

前提条件

このチュートリアルを開始する前に、 Java SE Development Kit (JDK) と Gradle が開発マシンにインストールされている必要があります。

また、Exchange Online メールボックスを持つ Microsoft の職場または学校アカウントも必要です。 Microsoft 365 テナントをお持ちでない場合は、 Microsoft 365 開発者プログラムを通じてテナントの資格を得る可能性があります。詳細については、 FAQ を参照してください。または、 1 か月間の無料試用版にサインアップするか、Microsoft 365 プランを購入することもできます。

注:

このチュートリアルは、OpenJDK バージョン 17.0.2 と Gradle 7.4.2 で記述されました。このガイドの手順は、他のバージョンで動作する可能性がありますが、テストされていません。

ポータルでアプリを登録する

残り 27 分

この演習では、ユーザー認証を有効にするために、Azure Active Directory に新しいアプリケーションを登録します。アプリケーションは、Microsoft Entra 管理センターを使用するか、 Microsoft Graph PowerShell SDK を使用して登録できます。

ユーザー認証用にアプリケーションを登録する

このセクションでは、デバイスコードフローを使用したユーザー認証をサポートするアプリケーションを登録します。

Microsoft Entra 管理センター
PowerShell

ブラウザーを開き、 Microsoft Entra 管理センターに移動し、グローバル管理者アカウントを使用してログインします。
左側のナビゲーションで [Microsoft Entra ID] を 選択し、[ ID] を展開し、[ アプリケーション] を展開して、[ アプリの登録] を選択します。
[新規登録] を選択します。アプリケーションの名前 (例: Graph User Auth Tutorial) を入力します。

必要に応じて、[サポートされているアカウントの種類] を設定します。以下のオプションがあります:

オプション	サインインできるユーザー
この組織のディレクトリ内のアカウントのみ	Microsoft 365 組織内のユーザーのみ
組織のディレクトリ内のアカウント	Microsoft 365 組織内のユーザー (職場または学校アカウント)
任意の組織ディレクトリ ... のアカウント。個人の Microsoft アカウント	Microsoft 365 組織内のユーザー (職場または学校アカウント) と個人の Microsoft アカウント

[リダイレクト URI]を空のままにします。
[登録] を選択します。アプリケーションの [概要 ] ページで、 アプリケーション (クライアント) ID の値をコピーして保存します。次の手順で必要になります。 [サポートされているアカウントの種類] に対してのみこの組織ディレクトリの [アカウント] を選択した場合は、ディレクトリ (テナント) ID もコピーして保存します。
[管理] の下の [認証] を選択します。 [ 詳細設定 ] セクションを見つけて、[ パブリッククライアントフローを許可する] トグルを [はい] に変更し、[保存] を選択 します。

PowerShell を使用するには、Microsoft Graph PowerShell SDK が必要です。インストール手順については、「 Microsoft Graph PowerShell SDK のインストール」を参照してください。

重要

PowerShell スクリプトには、アプリケーション管理者、クラウドアプリケーション管理者、またはグローバル管理者ロールを持つ職場/学校アカウントが必要です。アカウントにアプリケーション開発者ロールがある場合は、Microsoft Entra 管理センターに登録できます。

RegisterAppForUserAuth.ps1という名前の新しいファイルを作成し、次のコードを追加します。

param(
  [Parameter(Mandatory=$true,
  HelpMessage="The friendly name of the app registration")]
  [String]
  $AppName,

  [Parameter(Mandatory=$false,
  HelpMessage="The sign in audience for the app")]
  [ValidateSet("AzureADMyOrg", "AzureADMultipleOrgs", `
  "AzureADandPersonalMicrosoftAccount", "PersonalMicrosoftAccount")]
  [String]
  $SignInAudience = "AzureADandPersonalMicrosoftAccount",

  [Parameter(Mandatory=$false)]
  [Switch]
  $StayConnected = $false
)

# Tenant to use in authentication.
# See https://learn.microsoft.com/azure/active-directory/develop/v2-oauth2-device-code#device-authorization-request
$authTenant = switch ($SignInAudience)
{
  "AzureADMyOrg" { "tenantId" }
  "AzureADMultipleOrgs" { "organizations" }
  "AzureADandPersonalMicrosoftAccount" { "common" }
  "PersonalMicrosoftAccount" { "consumers" }
  default { "invalid" }
}

if ($authTenant -eq "invalid")
{
  Write-Host -ForegroundColor Red "Invalid sign in audience:" $SignInAudience
  Exit
}

# Requires an admin
Connect-MgGraph -Scopes "Application.ReadWrite.All User.Read" -UseDeviceAuthentication -ErrorAction Stop

# Get context for access to tenant ID
$context = Get-MgContext -ErrorAction Stop

if ($authTenant -eq "tenantId")
{
  $authTenant = $context.TenantId
}

# Create app registration
$appRegistration = New-MgApplication -DisplayName $AppName -SignInAudience $SignInAudience `
 -IsFallbackPublicClient -ErrorAction Stop
Write-Host -ForegroundColor Cyan "App registration created with app ID" $appRegistration.AppId

# Create corresponding service principal
if ($SignInAudience -ne "PersonalMicrosoftAccount")
{
  New-MgServicePrincipal -AppId $appRegistration.AppId -ErrorAction SilentlyContinue `
   -ErrorVariable SPError | Out-Null
  if ($SPError)
  {
    Write-Host -ForegroundColor Red "A service principal for the app could not be created."
    Write-Host -ForegroundColor Red $SPError
    Exit
  }

  Write-Host -ForegroundColor Cyan "Service principal created"
}

Write-Host
Write-Host -ForegroundColor Green "SUCCESS"
Write-Host -ForegroundColor Cyan -NoNewline "Client ID: "
Write-Host -ForegroundColor Yellow $appRegistration.AppId
Write-Host -ForegroundColor Cyan -NoNewline "Auth tenant: "
Write-Host -ForegroundColor Yellow $authTenant

if ($StayConnected -eq $false)
{
  Disconnect-MgGraph | Out-Null
  Write-Host "Disconnected from Microsoft Graph"
}
else
{
  Write-Host
  Write-Host -ForegroundColor Yellow `
   "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph"
}

ファイルを保存します。
PowerShell を開き、現在のディレクトリを RegisterAppForUserAuth.ps1の場所に変更します。

次のコマンドを実行し、<audience-value> を目的の値に置き換えます (下の表を参照)。

.\RegisterAppForUserAuth.ps1 -AppName "Graph User Auth Tutorial" -SignInAudience <audience-value>

SignInAudience 値	サインインできるユーザー
`AzureADMyOrg`	Microsoft 365 組織内のユーザーのみ
`AzureADMultipleOrgs`	Microsoft 365 組織内のユーザー (職場または学校アカウント)
`AzureADandPersonalMicrosoftAccount`	Microsoft 365 組織内のユーザー (職場または学校アカウント) と個人の Microsoft アカウント
`PersonalMicrosoftAccount`	個人の Microsoft アカウントのみ

プロンプトに従ってブラウザーで https://microsoft.com/devicelogin を開き、指定されたコードを入力し、認証プロセスを完了します。
スクリプト出力から クライアント ID と 認証テナント の値をコピーします。これらの値は、次の手順で必要になります。
```
SUCCESS
Client ID: 2fb1652f-a9a0-4db9-b220-b224b8d9d38b
Auth tenant: common
```

注:

アプリの登録に対して Microsoft Graph のアクセス許可を構成していないことに注意してください。これは、サンプルで動的同意を使用して、ユーザー認証の特定のアクセス許可を要求するためです。

Java コンソールアプリを作成する

残り 25 分

このセクションでは、基本的な Java コンソールアプリを作成します。

プロジェクトを作成するディレクトリでコマンドラインインターフェイス (CLI) を開きます。次のコマンドを実行して、新しい Gradle プロジェクトを作成します。
```
gradle init --dsl groovy --test-framework junit --type java-application --project-name graphtutorial --package graphtutorial
```
プロジェクトが作成されたら、次のコマンドを実行して CLI でアプリを実行して動作することを確認します。
```
./gradlew --console plain run
```
動作する場合、アプリは Hello World.を出力する必要があります。

依存関係のインストール

次に進む前に、後で使用するいくつかの依存関係を追加します。

ユーザーを認証し、アクセストークンを取得するための Java 用の Azure Identity クライアントライブラリ。
Microsoft Graph SDK for Java を使用して Microsoft Graph を呼び出します。

./app/build.gradle を開きます。 dependencies セクションを更新して、これらの依存関係を追加します。

dependencies {
    // Use JUnit test framework.
    testImplementation 'junit:junit:4.13.2'

    // This dependency is used by the application.
    implementation 'com.google.guava:guava:33.2.1-jre'
    implementation 'com.azure:azure-identity:1.13.0'
    implementation 'com.microsoft.graph:microsoft-graph:6.13.0'
}

./app/build.gradle の末尾に次を追加します。
```
run {
    standardInput = System.in
}
```
次回プロジェクトをビルドするときに、Gradle はこれらの依存関係をダウンロードします。

アプリケーション設定を読み込む

このセクションでは、アプリ登録の詳細をプロジェクトに追加します。

./app/src/main/resources ディレクトリに graphtutorial という名前の新しいディレクトリを作成します。
oAuth.properties という名前の ./app/src/main/resources/graphtutorial ディレクトリに新しいファイルを作成し、そのファイルに次のテキストを追加します。
```
app.clientId=YOUR_CLIENT_ID_HERE
app.tenantId=common
app.graphUserScopes=user.read,mail.read,mail.send
```

次の表に従って値を更新します。

設定	値
`app.clientId`	アプリ登録のクライアント ID
`app.tenantId`	組織内のユーザーのみがサインインできるようにするオプションを選択した場合は、この値をテナント ID に変更します。それ以外の場合は、 `common`のままにします。

重要

git などのソース管理を使用している場合は、誤ってアプリ ID が漏洩しないように 、ソース管理から oAuth.properties ファイルを除外することをお勧めします。

アプリを設計する

このセクションでは、簡単なコンソールベースのメニューを作成します。

./app/src/main/java/graphtutorial/App.java を開き、次のimport ステートメントを追加します。

package graphtutorial;

import java.io.IOException;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.util.InputMismatchException;
import java.util.Properties;
import java.util.Scanner;

import com.microsoft.graph.models.Message;
import com.microsoft.graph.models.MessageCollectionResponse;
import com.microsoft.graph.models.User;

既存の main 関数を、以下の関数で置き換えます。

public static void main(String[] args) {
    System.out.println("Java Graph Tutorial");
    System.out.println();

    final Properties oAuthProperties = new Properties();
    try {
        oAuthProperties.load(App.class.getResourceAsStream("oAuth.properties"));
    } catch (IOException e) {
        System.out.println("Unable to read OAuth configuration. Make sure you have a properly formatted oAuth.properties file. See README for details.");
        return;
    }

    initializeGraph(oAuthProperties);

    greetUser();

    Scanner input = new Scanner(System.in);

    int choice = -1;

    while (choice != 0) {
        System.out.println("Please choose one of the following options:");
        System.out.println("0. Exit");
        System.out.println("1. Display access token");
        System.out.println("2. List my inbox");
        System.out.println("3. Send mail");
        System.out.println("4. Make a Graph call");

        try {
            choice = input.nextInt();
        } catch (InputMismatchException ex) {
            // Skip over non-integer input
        }

        input.nextLine();

        // Process user choice
        switch(choice) {
            case 0:
                // Exit the program
                System.out.println("Goodbye...");
                break;
            case 1:
                // Display access token
                displayAccessToken();
                break;
            case 2:
                // List emails from user's inbox
                listInbox();
                break;
            case 3:
                // Send an email message
                sendMail();
                break;
            case 4:
                // Run any Graph code
                makeGraphCall();
                break;
            default:
                System.out.println("Invalid choice");
        }
    }

    input.close();
}

ファイルの末尾に次のプレースホルダーメソッドを追加します。後の手順で実装します。

private static void initializeGraph(Properties properties) {
    // TODO
}

private static void greetUser() {
    // TODO
}

private static void displayAccessToken() {
    // TODO
}

private static void listInbox() {
    // TODO
}

private static void sendMail() {
    // TODO
}

private static void makeGraphCall() {
    // TODO
}

これにより、基本的なメニューが実装され、コマンドラインからユーザーの選択が読み取ります。

./app/src/test/java/graphtutorial/AppTest.javaを削除します。

ユーザー認証を追加する

残り 19 分

このセクションでは、前の演習のアプリケーションを拡張して、Azure AD での認証をサポートします。これは、Microsoft Graph を呼び出すために必要な OAuth アクセストークンを取得するために必要です。この手順では、 Java 用 Azure Identity クライアントライブラリをアプリケーションに統合し、 Microsoft Graph SDK for Java の認証を構成します。

Azure Identity ライブラリには、OAuth2 トークンフローを実装する多数の TokenCredential クラスが用意されています。 Microsoft Graph クライアントライブラリでは、これらのクラスを使用して Microsoft Graph への呼び出しを認証します。

ユーザー認証用に Graph クライアントを構成する

このセクションでは、 DeviceCodeCredential クラスを使用して、デバイスコードフローを使用してアクセストークンを要求します。

./app/src/main/java/graphtutorial ディレクトリに Graph.java という名前の新しいファイルを作成し、そのファイルに次のコードを追加します。

package graphtutorial;

import java.util.List;
import java.util.Properties;
import java.util.function.Consumer;

import com.azure.core.credential.AccessToken;
import com.azure.core.credential.TokenRequestContext;
import com.azure.identity.DeviceCodeCredential;
import com.azure.identity.DeviceCodeCredentialBuilder;
import com.azure.identity.DeviceCodeInfo;
import com.microsoft.graph.models.BodyType;
import com.microsoft.graph.models.EmailAddress;
import com.microsoft.graph.models.ItemBody;
import com.microsoft.graph.models.Message;
import com.microsoft.graph.models.MessageCollectionResponse;
import com.microsoft.graph.models.Recipient;
import com.microsoft.graph.models.User;
import com.microsoft.graph.serviceclient.GraphServiceClient;
import com.microsoft.graph.users.item.sendmail.SendMailPostRequestBody;

空の Graph クラス定義を追加します。
```
public class Graph {
}
```

Graph クラスに次のコードを追加します。

private static Properties _properties;
private static DeviceCodeCredential _deviceCodeCredential;
private static GraphServiceClient _userClient;

public static void initializeGraphForUserAuth(Properties properties, Consumer<DeviceCodeInfo> challenge) throws Exception {
    // Ensure properties isn't null
    if (properties == null) {
        throw new Exception("Properties cannot be null");
    }

    _properties = properties;

    final String clientId = properties.getProperty("app.clientId");
    final String tenantId = properties.getProperty("app.tenantId");
    final String[] graphUserScopes = properties.getProperty("app.graphUserScopes").split(",");

    _deviceCodeCredential = new DeviceCodeCredentialBuilder()
        .clientId(clientId)
        .tenantId(tenantId)
        .challengeConsumer(challenge)
        .build();

    _userClient = new GraphServiceClient(_deviceCodeCredential, graphUserScopes);
}

App.javaの空の initializeGraph 関数を次のように置き換えます。

private static void initializeGraph(Properties properties) {
    try {
        Graph.initializeGraphForUserAuth(properties,
            challenge -> System.out.println(challenge.getMessage()));
    } catch (Exception e)
    {
        System.out.println("Error initializing Graph for user auth");
        System.out.println(e.getMessage());
    }
}

このコードでは、 DeviceCodeCredential オブジェクトと GraphServiceClient オブジェクトの 2 つのプライベートプロパティを宣言します。 InitializeGraphForUserAuth関数は、DeviceCodeCredentialの新しいインスタンスを作成し、そのインスタンスを使用してGraphServiceClientの新しいインスタンスを作成します。 _userClientを介して Microsoft Graph に API 呼び出しが行われるたびに、提供された資格情報を使用してアクセストークンを取得します。

DeviceCodeCredential をテストする

次に、 DeviceCodeCredentialからアクセストークンを取得するコードを追加します。

次の関数を Graph クラスに追加します。

public static String getUserToken() throws Exception {
    // Ensure credential isn't null
    if (_deviceCodeCredential == null) {
        throw new Exception("Graph has not been initialized for user auth");
    }

    final String[] graphUserScopes = _properties.getProperty("app.graphUserScopes").split(",");

    final TokenRequestContext context = new TokenRequestContext();
    context.addScopes(graphUserScopes);

    final AccessToken token = _deviceCodeCredential.getTokenSync(context);
    return token.getToken();
}

App.javaの空の displayAccessToken 関数を次のように置き換えます。

private static void displayAccessToken() {
    try {
        final String accessToken = Graph.getUserToken();
        System.out.println("Access token: " + accessToken);
    } catch (Exception e) {
        System.out.println("Error getting access token");
        System.out.println(e.getMessage());
    }
}

アプリをビルドして実行します。オプションの入力を求められたら、「 1 」と入力します。アプリケーションに URL とデバイスコードが表示されます。

Java Graph Tutorial

Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. Make a Graph call
1
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and
enter the code RB2RUD56D to authenticate.

ブラウザーを開き、表示された URL を参照します。指定したコードを入力し、サインインします。

重要

https://microsoft.com/deviceloginを参照するときにブラウザーにログインしている既存の Microsoft 365 アカウントに注意してください。プロファイル、ゲストモード、プライベートモードなどのブラウザー機能を使用して、テストに使用するアカウントとして認証することを確認します。
完了したら、アプリケーションに戻り、アクセストークンを表示します。

ヒント

検証とデバッグ のみを目的として、 https://jwt.msで Microsoft のオンライントークンパーサーを使用してユーザーアクセストークンをデコードできます (職場または学校アカウントの場合のみ)。これは、Microsoft Graph を呼び出すときにトークンエラーが発生した場合に役立ちます。たとえば、トークン内の scp 要求に、想定される Microsoft Graph アクセス許可スコープが含まれていることを確認します。

ユーザーを取得する

残り 14 分

このセクションでは、Microsoft Graph をアプリケーションに組み込みます。このアプリケーションでは、 Microsoft Graph Java クライアントライブラリを使用して Microsoft Graph を呼び出します。

Graph.javaを開き、Graph クラスに次の関数を追加します。

public static User getUser() throws Exception {
    // Ensure client isn't null
    if (_userClient == null) {
        throw new Exception("Graph has not been initialized for user auth");
    }

    return _userClient.me().get(requestConfig -> {
        requestConfig.queryParameters.select = new String[] {"displayName", "mail", "userPrincipalName"};
    });
}

App.javaの空の greetUser 関数を次のように置き換えます。

private static void greetUser() {
    try {
        final User user = Graph.getUser();
        // For Work/school accounts, email is in mail property
        // Personal accounts, email is in userPrincipalName
        final String email = user.getMail() == null ? user.getUserPrincipalName() : user.getMail();
        System.out.println("Hello, " + user.getDisplayName() + "!");
        System.out.println("Email: " + email);
    } catch (Exception e) {
        System.out.println("Error getting user");
        System.out.println(e.getMessage());
    }
}

今すぐアプリを実行すると、アプリにログインすると名前で歓迎されます。

Hello, Megan Bowen!
Email: MeganB@contoso.com

コードの説明

greetUser関数のコードについて考えてみましょう。ほんの数行ですが、注意する必要がある重要な詳細がいくつかあります。

'me' へのアクセス

関数は、Get user API への要求をビルドする_userClient.me要求ビルダーを使用します。この API には、次の 2 つの方法でアクセスできます。

GET /me
GET /users/{user-id}

この場合、コードは GET /me API エンドポイントを呼び出します。これは、ユーザー ID を知らずに認証されたユーザーを取得するためのショートカットメソッドです。

注:

GET /me API エンドポイントは認証されたユーザーを取得するため、ユーザー認証を使用するアプリでのみ使用できます。アプリ専用認証アプリは、このエンドポイントにアクセスできません。

特定のプロパティの要求

関数は、要求構成で select プロパティを使用して、必要なプロパティのセットを指定します。これにより、 $select クエリパラメーターが API 呼び出しに追加されます。

厳密に型指定された戻り値の型

関数は、API からの JSON 応答から逆シリアル化された com.microsoft.graph.models.User オブジェクトを返します。コードは selectを使用するため、返される User オブジェクトには、要求されたプロパティのみが値を持ちます。その他のすべてのプロパティには既定値が設定されます。

受信トレイを一覧表示する

残り 11 分

このセクションでは、ユーザーのメール受信トレイにメッセージを一覧表示する機能を追加します。

Graph.javaを開き、Graph クラスに次の関数を追加します。

public static MessageCollectionResponse getInbox() throws Exception {
    // Ensure client isn't null
    if (_userClient == null) {
        throw new Exception("Graph has not been initialized for user auth");
    }

    return _userClient.me()
        .mailFolders()
        .byMailFolderId("inbox")
        .messages()
        .get(requestConfig -> {
            requestConfig.queryParameters.select = new String[] { "from", "isRead", "receivedDateTime", "subject" };
            requestConfig.queryParameters.top = 25;
            requestConfig.queryParameters.orderby = new String[] { "receivedDateTime DESC" };
        });
}

App.javaの空の listInbox 関数を次のように置き換えます。

private static void listInbox() {
    try {
        final MessageCollectionResponse messages = Graph.getInbox();

        // Output each message's details
        for (Message message: messages.getValue()) {
            System.out.println("Message: " + message.getSubject());
            System.out.println("  From: " + message.getFrom().getEmailAddress().getName());
            System.out.println("  Status: " + (message.getIsRead() ? "Read" : "Unread"));
            System.out.println("  Received: " + message.getReceivedDateTime()
                // Values are returned in UTC, convert to local time zone
                .atZoneSameInstant(ZoneId.systemDefault()).toLocalDateTime()
                .format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT)));
        }

        final Boolean moreMessagesAvailable = messages.getOdataNextLink() != null;
        System.out.println("\nMore messages available? " + moreMessagesAvailable);
    } catch (Exception e) {
        System.out.println("Error getting inbox");
        System.out.println(e.getMessage());
    }
}

アプリを実行し、サインインし、オプション 2 を選択して受信トレイを一覧表示します。

Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. Make a Graph call
2
Message: Updates from Ask HR and other communities
  From: Contoso Demo on Yammer
  Status: Read
  Received: 12/30/2021, 4:54:54 AM
Message: Employee Initiative Thoughts
  From: Patti Fernandez
  Status: Read
  Received: 12/28/2021, 5:01:10 PM
Message: Voice Mail (11 seconds)
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 5:00:46 PM
Message: Our Spring Blog Update
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 4:49:46 PM
Message: Atlanta Flight Reservation
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 4:35:42 PM
Message: Atlanta Trip Itinerary - down time
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 4:22:04 PM

...

More messages available? true

コードの説明

getInbox関数のコードについて考えてみましょう。

既知のメールフォルダーへのアクセス

関数は、list messages API への要求をビルドする_userClient.me().mailFolders().byMailFolderId("inbox").messages()要求ビルダーを使用します。 byMailFolderId("inbox")要求ビルダーが含まれているため、API は要求されたメールフォルダー内のメッセージのみを返します。この場合、受信トレイはユーザーのメールボックス内の既定の既知のフォルダーであるため、既知の名前を使用してアクセスできます。既知の名前をメールフォルダーの ID プロパティに置き換えることで、既定以外のフォルダーにも同じ方法でアクセスします。使用可能な既知のフォルダー名の詳細については、「 mailFolder リソースの種類」を参照してください。

コレクションへのアクセス

1 つのオブジェクトを返す前のセクションの getUser 関数とは異なり、このメソッドはメッセージのコレクションを返します。コレクションを返す Microsoft Graph のほとんどの API では、使用可能なすべての結果が 1 つの応答で返されるわけではありません。代わりに、ページングを使用して結果の一部を返しながら、クライアントが次の "ページ" を要求するメソッドを提供します。

既定のページサイズ

ページングを使用する API では、既定のページサイズが実装されます。メッセージの場合、既定値は 10 です。クライアントは、 $top クエリパラメーターを使用して、より多く (またはそれ以下) を要求できます。 getInboxでは、これは要求構成の top プロパティで実現されます。

注:

topで設定される値は、明示的な数値ではなく、上限です。 API は、指定した値までのメッセージ数を返します。

後続のページを取得する

サーバーで使用可能な結果が増える場合、コレクション応答には、次のページにアクセスするための API URL を含む @odata.nextLink プロパティが含まれます。 Java クライアントライブラリでは、これをコレクション応答オブジェクトの getOdataNextLink メソッドとして公開します。このメソッドが null 以外を返す場合は、使用可能な結果が増えます。

コレクションを並べ替える

関数は、要求構成で orderBy プロパティを使用して、メッセージの受信時刻 (receivedDateTime プロパティ) で並べ替えられた結果を要求します。 DESC キーワードが含まれているため、最近受信したメッセージが最初に一覧表示されます。これにより、 $orderby クエリパラメーターが API 呼び出しに追加されます。

メールを送信する

残り 8 分

このセクションでは、認証されたユーザーとして電子メールメッセージを送信する機能を追加します。

Graph.javaを開き、Graph クラスに次の関数を追加します。

public static void sendMail(String subject, String body, String recipient) throws Exception {
    // Ensure client isn't null
    if (_userClient == null) {
        throw new Exception("Graph has not been initialized for user auth");
    }

    // Create a new message
    final Message message = new Message();
    message.setSubject(subject);
    final ItemBody itemBody = new ItemBody();
    itemBody.setContent(body);
    itemBody.setContentType(BodyType.Text);
    message.setBody(itemBody);

    final EmailAddress emailAddress = new EmailAddress();
    emailAddress.setAddress(recipient);
    final Recipient toRecipient = new Recipient();
    toRecipient.setEmailAddress(emailAddress);
    message.setToRecipients(List.of(toRecipient));

    final SendMailPostRequestBody postRequest = new SendMailPostRequestBody();
    postRequest.setMessage(message);

    // Send the message
    _userClient.me()
        .sendMail()
        .post(postRequest);
}

App.javaの空の sendMail 関数を次のように置き換えます。

private static void sendMail() {
    try {
        // Send mail to the signed-in user
        // Get the user for their email address
        final User user = Graph.getUser();
        final String email = user.getMail() == null ? user.getUserPrincipalName() : user.getMail();

        Graph.sendMail("Testing Microsoft Graph", "Hello world!", email);
        System.out.println("\nMail sent.");
    } catch (Exception e) {
        System.out.println("Error sending mail");
        System.out.println(e.getMessage());
    }
}

アプリを実行し、サインインし、オプション 3 を選択して自分にメールを送信します。
```
Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. Make a Graph call
3

Mail sent.
```
注:

Microsoft 365 開発者プログラムの開発者テナントでテストしている場合は、送信したメールが配信されず、配信不能レポートが届く場合があります。このような場合は、 Microsoft 365 管理センターからサポートにお問い合わせください。
メッセージが受信されたことを確認するには、オプション 2 を選択して受信トレイを一覧表示します。

コードの説明

sendMail関数のコードについて考えてみましょう。

メールの送信

関数は、メール送信 API への要求をビルドする_userClient.me().sendMail()要求ビルダーを使用します。要求ビルダーは、送信するメッセージを含む SendMailPostRequestBody オブジェクトを受け取ります。

オブジェクトの作成

データのみを読み取る Microsoft Graph の以前の呼び出しとは異なり、この呼び出しではデータが作成されます。クライアントライブラリでこれを行うには、new キーワードを使用してデータを表すクラスのインスタンス (この場合はcom.microsoft.graph.models.Message) を作成し、目的のプロパティを設定してから API 呼び出しで送信します。呼び出しはデータを送信しているため、getの代わりに post メソッドが使用されます。

省略可能: 独自のコードを追加する

残り 5 分

このセクションでは、独自の Microsoft Graph 機能をアプリケーションに追加します。これは、Microsoft Graph ドキュメントまたは Graph エクスプローラーのコードスニペット、または作成したコードです。このセクションは省略可能です。

アプリを更新する

Graph.javaを開き、Graph クラスに次の関数を追加します。
```
public static void makeGraphCall() {
    // INSERT YOUR CODE HERE
}
```

App.javaの空の MakeGraphCallAsync 関数を次のように置き換えます。

private static void makeGraphCall() {
    try {
        Graph.makeGraphCall();
    } catch (Exception e) {
        System.out.println("Error making Graph call");
        System.out.println(e.getMessage());
    }
}

API を選択する

試したい API を Microsoft Graph で見つけます。たとえば、 Create イベント API です。 API ドキュメントの例のいずれかを使用するか、Graph Explorer で API 要求をカスタマイズし、生成されたスニペットを使用できます。

アクセス許可を構成する

選択した API のリファレンスドキュメントの [アクセス許可] セクションを確認して、サポートされている認証方法を確認します。たとえば、一部の API では、アプリ専用アカウントや個人用 Microsoft アカウントがサポートされていません。

ユーザー認証を使用して API を呼び出すには (API でユーザー (委任された) 認証がサポートされている場合)、 oAuth.properties に必要なアクセス許可スコープを追加します。
アプリ専用認証を使用して API を呼び出すには、アプリのみの認証に関するチュートリアルを参照してください。

コードを追加する

コードを Graph.java の makeGraphCallAsync関数にコピーします。ドキュメントまたは Graph Explorer からスニペットをコピーする場合は、必ず GraphServiceClient の名前を _userClient に変更してください。

次の方法で共有

Microsoft Graph を使って Java アプリを構築する

前提条件

ポータルでアプリを登録する

ユーザー認証用にアプリケーションを登録する

Java コンソールアプリを作成する

依存関係のインストール

アプリケーション設定を読み込む

アプリを設計する

ユーザー認証を追加する

ユーザー認証用に Graph クライアントを構成する

DeviceCodeCredential をテストする

ユーザーを取得する

コードの説明

'me' へのアクセス

特定のプロパティの要求

厳密に型指定された戻り値の型

受信トレイを一覧表示する

コードの説明

既知のメールフォルダーへのアクセス

コレクションへのアクセス

既定のページサイズ

後続のページを取得する

コレクションを並べ替える

メールを送信する

コードの説明

メールの送信

オブジェクトの作成

省略可能: 独自のコードを追加する

アプリを更新する

API を選択する

アクセス許可を構成する

コードを追加する

おめでとうございます。

Java サンプル

次の方法で共有

Microsoft Graph を使って Java アプリを構築する

前提条件

ポータルでアプリを登録する

ユーザー認証用にアプリケーションを登録する

Java コンソール アプリを作成する

依存関係のインストール

アプリケーション設定を読み込む

アプリを設計する

ユーザー認証を追加する

ユーザー認証用に Graph クライアントを構成する

DeviceCodeCredential をテストする

ユーザーを取得する

コードの説明

'me' へのアクセス

特定のプロパティの要求

厳密に型指定された戻り値の型

受信トレイを一覧表示する

コードの説明

既知のメール フォルダーへのアクセス

コレクションへのアクセス

既定のページ サイズ

後続のページを取得する

コレクションを並べ替える

メールを送信する

コードの説明

メールの送信

オブジェクトの作成

省略可能: 独自のコードを追加する

アプリを更新する

API を選択する

アクセス許可を構成する

コードを追加する

おめでとうございます。

Java サンプル

Java コンソールアプリを作成する

既知のメールフォルダーへのアクセス

既定のページサイズ