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 จะส่งเว็บฮุกหรือการแจ้งเตือนโดยอัตโนมัติทุกครั้งที่มีการเปลี่ยนแปลง (เช่น มีอีเมลใหม่เข้ามา) ซึ่งจะช่วยให้แอปไม่ต้องสำรวจเซิร์ฟเวอร์อย่างต่อเนื่องเพื่อหาข้อมูลอัปเดต ดูข้อมูลเพิ่มเติมได้ที่ข้อความพุช
- ใบรับรอง S/MIME
ใบรับรองดิจิทัลที่อัปโหลดไปยังชื่อแทนสำหรับส่งเป็นที่เฉพาะเจาะจงซึ่งอนุญาตให้ผู้ใช้ ส่งอีเมลที่เข้ารหัสและลงนามแบบดิจิทัล เพื่อให้มั่นใจในความปลอดภัยของข้อความและ ความถูกต้องของผู้ส่ง ดูข้อมูลเพิ่มเติมได้ที่จัดการใบรับรอง S/MIME
- อีเมลแทนสำหรับส่ง
ซึ่งแสดงถึงอีเมลต่างๆ ที่บัญชีได้รับอนุญาตให้ส่งอีเมลจากอีเมลเหล่านั้น ทุกบัญชีจะมีชื่อแทนอย่างน้อย 1 ชื่อที่แสดงถึง อีเมลหลัก นามแฝงจะสอดคล้องกับฟีเจอร์ "ส่งอีเมลในชื่อ" ในอินเทอร์เฟซเว็บของ Gmail และยังเป็นพื้นฐานสำหรับการกำหนดค่า ลายเซ็นอีเมลต่อที่อยู่อีกด้วย ดูข้อมูลเพิ่มเติมได้ที่จัดการ นามแฝง
- ชุดข้อความ
กลุ่มข้อความที่เกี่ยวข้องซึ่งประกอบกันเป็นการสนทนา ในแอปไคลเอ็นต์อีเมล ชุดข้อความจะเกิดขึ้นเมื่อผู้รับอย่างน้อย 1 รายตอบกลับข้อความ ด้วยข้อความของตนเอง ดูข้อมูลเพิ่มเติมได้ที่จัดการ เธรด
หัวข้อที่เกี่ยวข้อง
ดูข้อมูลเกี่ยวกับการพัฒนาด้วย Google Workspace API รวมถึงการจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ได้ที่พัฒนาบน Google Workspace
ดูวิธีกำหนดค่าและเรียกใช้แอป Gmail API ได้ที่คู่มือเริ่มต้น