Gmail API を使用して POP と IMAP の設定を構成する

このドキュメントでは、Gmail API を使用して POP プロトコルと IMAP プロトコルを管理する方法について説明します。

POP と IMAP は、Gmail のメールを他のメール クライアントで読むための 2 つの方法です。POP は古い技術であり、1 台のパソコンでのみ使用できます。POP ベースのメールはダウンロードされるため、新着メールをダウンロードする頻度を指定します。IMAP は複数のデバイスで使用でき、メールはリアルタイムで同期されます。

Gmail API の settings リソースを使用して、Gmail で POP プロトコルと IMAP プロトコルを処理する方法を構成できます。

POP

アカウントの POP 設定は、PopSettings オブジェクトを使用して管理できます。

アクセスを有効または無効にする

accessWindow フィールドを使用してアクセスを制御します。このフィールドは、POP が有効かどうかと、API が取得するメッセージを決定します。

値 効果
disabled POP 経由でアクセスできるメッセージはありません
allMail 取得されていないすべてのメッセージに POP でアクセスできる
fromNowOn POP でアクセスできるのは新しいメッセージのみ

メール処理

API が取得するメッセージの処理は、disposition フィールドで構成します。

値 効果
archive INBOX からメッセージを移動する
leaveInInbox 何もせず、INBOX のメッセージを未読のままにする
markRead メッセージを INBOX に残して既読にする
trash メッセージを TRASH に移動する

IMAP

アカウントの IMAP 設定は、ImapSettings オブジェクトを使用して管理できます。

アクセスを有効または無効にする

ブール値の enabled フィールドを使用してアクセスを制御します。このフィールドは、アカウントで IMAP が有効になっているかどうかを決定します。

メール処理

expungeBehavior フィールドを使用して、メッセージが削除済みとしてマークされ、最後に表示された IMAP フォルダから削除されたときのメッセージの処理を設定します。

値 効果
archive 削除済みとしてマークされたメッセージを INBOX から移動する
deleteForever 削除済みとしてマークされたメッセージを完全に削除する
trash 削除済みとしてマークされたメッセージを TRASH に移動する

ブール値の autoExpunge フィールドが true の場合、IMAP で削除済みとしてマークされたメッセージは、Gmail で直ちに削除されます。それ以外の場合、メッセージは IMAP クライアントが明示的に削除をリクエストするまで残ります。