Gmail API คือ RESTful API ที่ช่วยให้คุณเข้าถึงกล่องจดหมาย Gmail และส่งอีเมลได้ สำหรับเว็บแอปพลิเคชันส่วนใหญ่ Gmail API เป็น ตัวเลือกที่ดีที่สุดสำหรับการเข้าถึงข้อมูล Gmail ของผู้ใช้ที่ได้รับอนุญาต และ เหมาะสำหรับแอปพลิเคชันต่างๆ เช่น
- การดึงข้อมูล การจัดทำดัชนี และการสำรองข้อมูลอีเมลแบบอ่านอย่างเดียว
- การส่งข้อความอัตโนมัติหรือแบบเป็นโปรแกรม
- การย้ายข้อมูลบัญชีอีเมล
- การจัดระเบียบอีเมล รวมถึงการกรองและการจัดเรียงข้อความ
- การกำหนดลายเซ็นอีเมลให้เป็นมาตรฐานทั่วทั้งองค์กร
คำทั่วไป
รายการคำศัพท์ทั่วไปที่ใช้ใน API นี้มีดังนี้
- ผู้มอบสิทธิ์และผู้รับมอบสิทธิ์
- ผู้มอบสิทธิ์คือผู้ใช้ Gmail ที่ให้สิทธิ์เข้าถึงกล่องจดหมายแก่ ผู้ใช้รายอื่นภายในองค์กร Google Workspace เดียวกัน ผู้ใช้ที่ได้รับสิทธิ์เข้าถึงนี้คือผู้รับมอบสิทธิ์ ผู้รับมอบสิทธิ์สามารถอ่าน ส่ง และลบข้อความ รวมถึงดูและเพิ่มรายชื่อติดต่อในนามของบัญชีของผู้มอบสิทธิ์ได้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อจัดการ ผู้รับมอบสิทธิ์
- Draft
- ข้อความที่ยังไม่ได้ส่ง คุณแทนที่ข้อความที่อยู่ในฉบับร่างได้
การส่งฉบับร่างจะลบฉบับร่างโดยอัตโนมัติและสร้างข้อความที่มี
SENTป้ายกำกับของระบบ ทรัพยากรdraftsแสดงถึงฉบับร่าง ดูข้อมูลเพิ่มเติมได้ที่การทำงานกับ ฉบับร่าง - ตัวกรอง
- กฎขั้นสูงที่กำหนดค่าไว้สำหรับบัญชีซึ่งประเมินข้อความขาเข้า เทียบกับเกณฑ์การจับคู่ที่เฉพาะเจาะจง (เช่น ผู้ส่ง เรื่อง หรือขนาด) เมื่อข้อความตรงกัน ตัวกรองจะทริกเกอร์การดำเนินการโดยอัตโนมัติ เช่น การเพิ่มหรือ นำป้ายกำกับออก หรือการส่งต่ออีเมลไปยังที่อยู่ที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่จัดการ ตัวกรอง
- อีเมลที่ใช้รับการส่งต่อ
- อีเมลที่เฉพาะเจาะจงและได้รับการยืนยันซึ่งกำหนดค่าให้รับข้อความที่ส่งต่ออัตโนมัติ จากบัญชีของผู้ใช้ ก่อนที่จะใช้อีเมลใน กฎการส่งต่อหรือตัวกรอง คุณต้องลงทะเบียนและยืนยันอีเมลเพื่อพิสูจน์ ความเป็นเจ้าของ ดูข้อมูลเพิ่มเติมได้ที่จัดการ การส่งต่อ
- ป้ายกำกับ
กลไกในการจัดระเบียบข้อความและชุดข้อความ เช่น คุณสามารถสร้างป้ายกำกับ "ภาษี" และนำไปใช้กับข้อความและเธรดทั้งหมดที่เกี่ยวข้องกับภาษีได้ ดูข้อมูลเพิ่มเติมได้ที่จัดการ ป้ายกำกับ
ซึ่งมีป้ายกำกับอยู่สองประเภทดังนี้
- ป้ายกำกับของระบบ
- ป้ายกำกับที่สร้างขึ้นภายใน เช่น
INBOX,TRASHหรือSPAMคุณ ลบหรือแก้ไขป้ายกำกับเหล่านี้ไม่ได้ อย่างไรก็ตาม คุณสามารถใช้หรือนำป้ายกำกับของระบบบางอย่าง เช่นINBOXออกจากข้อความและเธรดได้ - ป้ายกำกับผู้ใช้
- ป้ายกำกับที่ผู้ใช้สร้างขึ้น ผู้ใช้หรือแอปพลิเคชันสามารถลบหรือแก้ไข
ป้ายกำกับเหล่านี้ได้ แหล่งข้อมูล
labelsแสดงถึงป้ายกำกับผู้ใช้
- ข้อความ
ข้อความอีเมลที่มีผู้ส่ง ผู้รับ เรื่อง และเนื้อหา หลังจาก สร้างข้อความแล้ว คุณจะเปลี่ยนแปลงข้อความนั้นไม่ได้ ทรัพยากร
messagesแสดงถึงข้อความ- ข้อความ Push
ระบบการแจ้งเตือนฝั่งเซิร์ฟเวอร์ที่ผสานรวมกับ Google Cloud Pub/Sub แอปพลิเคชันสามารถ "ดู" กล่องจดหมายได้ และ Gmail API จะส่ง Webhook หรือการแจ้งเตือนโดยอัตโนมัติทุกครั้งที่มีการเปลี่ยนแปลง (เช่น มีอีเมลใหม่ เข้ามา) จึงไม่จำเป็นที่แอปจะต้องสำรวจเซิร์ฟเวอร์เพื่อหาข้อมูลอัปเดต ดูข้อมูลเพิ่มเติมได้ที่การแจ้งเตือนแบบพุช
- ใบรับรอง S/MIME
ใบรับรองดิจิทัลที่อัปโหลดไปยังอีเมลแทนสำหรับส่งในนามที่เฉพาะเจาะจง ใบรับรองเหล่านี้ ช่วยให้คุณส่งอีเมลที่เข้ารหัสและเซ็นชื่อแบบดิจิทัลได้ เพื่อให้มั่นใจในความปลอดภัยของข้อความ และความถูกต้องของผู้ส่ง ดูข้อมูลเพิ่มเติมได้ที่หัวข้อจัดการใบรับรอง S/MIME
- อีเมลแทนสำหรับส่ง
ซึ่งแสดงถึงอีเมลต่างๆ ที่บัญชีได้รับอนุญาตให้ส่งอีเมลจากอีเมลเหล่านั้น ทุกบัญชีจะมีชื่อแทนอย่างน้อย 1 ชื่อที่แสดงถึง อีเมลหลัก ชื่อแทนจะสอดคล้องกับฟีเจอร์ "ส่งอีเมลในชื่อ" ในอินเทอร์เฟซเว็บของ Gmail และยังเป็นพื้นฐานสำหรับ การกำหนดค่าลายเซ็นอีเมลต่อที่อยู่อีกด้วย ดูข้อมูลเพิ่มเติมได้ที่จัดการ นามแฝง
- ชุดข้อความ
ชุดข้อความที่เกี่ยวข้องซึ่งประกอบกันเป็นการสนทนา ในโปรแกรมรับส่งอีเมล ชุดข้อความจะเกิดขึ้นเมื่อผู้รับอย่างน้อย 1 คนตอบกลับข้อความด้วยข้อความของตนเอง ดูข้อมูลเพิ่มเติมได้ที่จัดการ เธรด
หัวข้อที่เกี่ยวข้อง
ดูข้อมูลเกี่ยวกับการพัฒนาด้วย Google Workspace API รวมถึงการจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ได้ที่พัฒนาบน Google Workspace
ดูวิธีกำหนดค่าและเรียกใช้แอป Gmail API ได้ที่คู่มือเริ่มต้น