Gmail API v1（Java）を使用して、
Gmailのメールボックスのユーザープロフィールを取得する
についてご紹介します。
APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Gmail API] JavaでGmail APIを使う
を参照ください。
本文中の引数にある「メールアドレス」の指定は、
OAuth 2.0使用の場合は「me」（自身）と指定してください。
「me」は認証されたユーザーを示します。
| No | 目次 | |
|---|---|---|
| 1 | プロフィールを取得 | |
| 1 | スコープ | |
| 2 | 実行 | |
| 3 | レスポンスの内容 |
1. プロフィールを取得
ユーザーのプロフィールを取得します。
1.1. スコープ
このAPIを実行するには、以下のいずれかのスコープを指定してください。
GmailScopes.MAIL_GOOGLE_COM
GmailScopes.GMAIL_MODIFY
GmailScopes.GMAIL_COMPOSE
GmailScopes.GMAIL_READONLY
GmailScopes.GMAIL_METADATA
⧉[Gmail API] JavaでGmail APIを使う(2.2 Gmailインスタンスを取得)
でスコープを指定してください。
1.2. 実行
public static void main(String[] args) throws Exception{
Gmail gmail = getGmail();
Gmail.Users users = gmail.users();
Gmail.Users.GetProfile profile = users.getProfile("メールアドレス");
Profile res = profile.execute();
System.out.println(res);
}
1.2.1. HTTPリクエスト
GET: https://gmail.googleapis.com/gmail/v1/users/{メールアドレス}/profile
が実行されます。
1.2.2. クエリパラメータ
クエリパラメータはありません。
1.3. レスポンスの内容
Profile
| メソッド | 戻り値 | 説明 |
|---|---|---|
| getEmailAddress | String | ユーザーの電子メールアドレス |
| getMessagesTotal | Integer | メールボックス内のメッセージの総数 |
| getThreadsTotal | Integer | メールボックス内のスレッドの総数 |
| getHistoryId | String | メールボックスの現在の履歴レコードID |