กำหนดค่าการตั้งค่า POP และ IMAP ด้วย Gmail API

เอกสารนี้อธิบายวิธีจัดการโปรโตคอล POP และ IMAP โดยใช้ Gmail API

POP และ IMAP เป็น 2 วิธีในการอ่านข้อความ Gmail ในโปรแกรมรับส่งอีเมลอื่นๆ POP เป็นเทคโนโลยีรุ่นเก่าที่ใช้กับคอมพิวเตอร์ได้เพียงเครื่องเดียวเท่านั้น ระบบจะดาวน์โหลดอีเมลที่ใช้ POP และคุณเป็นผู้ตัดสินความถี่ในการดาวน์โหลดอีเมลใหม่ คุณสามารถใช้การเข้าถึงแบบ IMAP ในอุปกรณ์ที่หลากหลายและระบบจะซิงค์อีเมลแบบเรียลไทม์

คุณใช้แหล่งข้อมูล settings ของ Gmail API เพื่อกำหนดวิธีที่ 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 หรือไม่

การจัดการข้อความ

กำหนดค่าการจำแนกข้อความเมื่อมีการทำเครื่องหมายว่าลบแล้วและล้างข้อมูล จากโฟลเดอร์ IMAP ที่มองเห็นล่าสุดด้วยฟิลด์ expungeBehavior

ค่า เอฟเฟ็กต์
archive ย้ายข้อความที่ทำเครื่องหมายว่าลบแล้วออกจากINBOX
deleteForever ลบข้อความที่ทำเครื่องหมายว่าถูกลบอย่างถาวร
trash ย้ายข้อความที่ทำเครื่องหมายว่าลบแล้วไปยังTRASH

หากฟิลด์บูลีน autoExpunge เป็น true Gmail จะลบข้อความอย่างถาวรทันทีเมื่อมีการ ทำเครื่องหมายว่าลบแล้วใน IMAP มิฉะนั้น ข้อความจะยังคงอยู่จนกว่าไคลเอ็นต์ IMAP จะขอให้นำออกอย่างชัดเจน