Gmail API로 POP 및 IMAP 설정 구성

이 문서에서는 Gmail API를 사용하여 POP 및 IMAP 프로토콜을 관리하는 방법을 설명합니다.

POP와 IMAP은 다른 이메일 클라이언트에서 Gmail 메일을 읽을 수 있는 두 가지 방법입니다. POP는 단일 컴퓨터용으로 설계된 이전 프로토콜입니다. POP를 사용하면 클라이언트가 메일을 다운로드하며, 새 메일을 다운로드할 빈도를 선택할 수 있습니다. IMAP은 여러 기기에서 작동하며 메일을 실시간으로 동기화합니다.

Gmail API의 settings 리소스를 사용하여 Gmail에서 POP 및 IMAP 프로토콜을 처리하는 방식을 구성할 수 있습니다.

POP

PopSettings 객체를 사용하여 계정의 POP 설정을 관리할 수 있습니다.

액세스 사용 설정 및 중지

accessWindow 필드로 액세스를 제어합니다. 이 필드는 POP가 사용 설정되었는지 여부와 API가 가져오는 메시지를 결정합니다.

값 효과
disabled POP를 통해 액세스할 수 있는 메시지가 없음
allMail 가져오지 않은 모든 메일은 POP를 통해 액세스할 수 있습니다.
fromNowOn POP를 통해 액세스할 수 있는 메시지는 새 메시지뿐입니다.

메일 처리

API가 가져오는 메시지의 처리 상태를 disposition 필드로 구성합니다.

값 효과
archive INBOX에서 메시지 이동
leaveInInbox 아무것도 하지 않음, INBOX에서 메일을 읽지 않은 상태로 둠
markRead INBOX에 메시지를 남기고 읽음으로 표시
trash 메일을 TRASH로 이동

IMAP

ImapSettings 객체를 사용하여 계정의 IMAP 설정을 관리할 수 있습니다.

액세스 사용 설정 및 중지

불리언 enabled 필드를 사용하여 액세스를 제어합니다. 이 필드는 계정에 IMAP이 사용 설정되어 있는지 여부를 결정합니다.

메일 처리

클라이언트가 메시지를 삭제된 것으로 표시하고 마지막으로 표시된 IMAP 폴더에서 삭제할 때 메시지의 처분을 구성하려면 expungeBehavior 필드를 사용하세요.

값 효과
archive 삭제됨으로 표시된 메일을 INBOX에서 이동
deleteForever 삭제로 표시된 메일 완전히 삭제
trash 삭제됨으로 표시된 메일을 TRASH로 이동

불리언 autoExpunge 필드가 true인 경우 클라이언트가 IMAP에서 삭제된 것으로 표시하면 Gmail은 즉시 메일을 삭제합니다. 그렇지 않으면 IMAP 클라이언트가 명시적으로 삭제를 요청할 때까지 메일이 유지됩니다.