กำหนดค่าการตั้งค่า 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 สำหรับบัญชีหรือไม่

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

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

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

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