nPOP PlusでGmailのOAuth 2.0を設定する

この手順では、自分のGoogle Cloudプロジェクトでデスクトップ用クライアントを作り、nPOP PlusでGmailを受信・送信できるようにします。すでにJSONを取得済みなら、同じプロジェクトで手順2と3を確認してから手順5へ進んでください。

1. Google Cloudプロジェクトを作る

「ブランディング」でアプリ名、ユーザーサポートメール、デベロッパーの連絡先を設定します。アプリ名はGoogleの同意画面に表示されます。
個人のGmailで使う場合は「対象（Audience）」で「外部」を選びます。自分で試す場合は公開ステータスを「テスト」のままにします。
同じ画面の「テストユーザー」で「ユーザーを追加」を押し、nPOP Plusで実際に使うGmailアドレスを登録して保存します。プロジェクトの管理に使うアドレスと異なる場合は、メールを読みたい側のアドレスを登録します。

「データアクセス」で「スコープを追加または削除」を開きます。
IMAP受信・SMTP送信に使う https://mail.google.com/ を追加します。検索結果に出ない場合は手動追加欄に入力します。
ログインしたメールアドレスの照合に使う https://www.googleapis.com/auth/userinfo.email も追加し、変更を保存します。

https://mail.google.com/ はGmailへの広いアクセスを許可する制限付きスコープです。テストユーザーでの動作確認と、一般利用者向けの公開審査は別です。GmailのOAuth仕様

「クライアント（Clients）」で「クライアントを作成」を押します。
アプリケーションの種類に デスクトップアプリ を選びます。名前を入力して「作成」を押します。
作成結果の画面で「JSONをダウンロード」を押し、ファイルを保存します。ファイル名を変更する必要はありません。作成時に取得できる情報はその場で保存してください。
このJSONは自分の認証設定に使います。公開ZIPや問い合わせに添付せず、自分で管理できる場所に置きます。

配布ZIPを展開し、補助プログラム nPOPGoogle.exe が本体と同じフォルダーにあることを確認します。
nPOP PlusでGmailのアカウントを追加するか、既存のGmailアカウントの設定を開きます。メールアドレスと受信ユーザー名は、登録したGmailアドレスに合わせます。
「Google OAuth」タブで「GmailでGoogle OAuthを使用する」にチェックを入れ、「OK」で保存します。Gmail用のIMAP・SMTP設定が適用されます。
アカウント設定を開き直し、「Google OAuth」→「Googleでログイン」を押します。手順4で保存したJSONを選びます。
ブラウザーで、テストユーザーに登録したGmailにログインします。同意画面でアプリ名、アカウント、要求される権限を確認して許可します。
認証が完了したらnPOP Plusに戻り、対象アカウントで「新着チェック」を押します。受信を確認したら、自分で受け取れる宛先にテストメールを送り、送信も確認します。

症状	確認すること
「アクセスをブロック」「審査プロセスを完了していません」	JSONを発行したプロジェクトの「対象」を開き、ブラウザーで選んだGmailがテストユーザーに入っているか確認します。複数のGoogleアカウントでログインしている場合は、同意画面で選んだアドレスも確認します。
JSONを選んでも認証が始まらない	クライアントの種類が「デスクトップアプリ」か、本体の隣に nPOPGoogle.exe があるかを確認します。
約1週間後に再ログインを求められる	外部アプリの「テスト」では、Gmail権限を含む更新トークンが7日で期限切れになります。「Googleでログイン」から再認証します。
認証後に受信・送信ができない	Googleの同意画面でメールへのアクセスを許可したか、アプリのアカウントとGoogleで選んだアドレスが一致するかを確認します。

OAuthの認証情報は、利用したPCのWindowsユーザー領域にDPAPIで保護して保存されます。USBに本体やINIをコピーした場合も、別のPCや別のWindowsユーザーではGoogleログインが必要です。この設定手順はGmailのIMAP・SMTP用です。