อภิธานศัพท์

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

คุณใช้คําศัพท์ต่อไปนี้ในเอกสารนี้

ส่วนเสริมการประชุมในปฏิทิน

ส่วนเสริมพิเศษประเภทหนึ่งที่ใช้เพื่อให้ผู้ให้บริการการประชุมแสดงตัวเลือกการประชุมได้ในกิจกรรมใน Google ปฏิทิน ส่วนเสริมเหล่านี้ต้องใช้โซลูชันการประชุมที่พัฒนามาอย่างดีเพื่อให้ส่วนเสริมเชื่อมต่อได้ ตามข้อกําหนดนี้ นักพัฒนาซอฟต์แวร์ส่วนใหญ่จึงไม่จําเป็นต้องสร้างส่วนเสริมการประชุมในปฏิทิน

โปรดดูข้อมูลเพิ่มเติมในส่วนเสริมการประชุมในปฏิทิน และดูการอัปเกรดส่วนเสริมที่เผยแพร่แล้วเพื่อดูข้อมูลเกี่ยวกับวิธีแปลงส่วนเสริมการประชุมของปฏิทินเป็นส่วนเสริมของ Google Workspace

Card

"หน้าเว็บ" ของ UI ส่วนเสริมรายการเดียว การ์ดประกอบด้วยออบเจ็กต์วิดเจ็ตต่างๆ (ปุ่ม ช่องข้อความ ส่วนหัว ฯลฯ)

ดูข้อมูลเพิ่มเติมได้ที่การ์ด

อิงตามการ์ด

ส่วนเสริมที่มีอินเทอร์เฟซผู้ใช้ปรากฏเป็นหน้าต่างในแถบด้านข้าง (หรือในอุปกรณ์เคลื่อนที่ เป็นหน้าต่างกิจกรรมอีกหน้าต่างหนึ่งที่เข้าถึงผ่านเมนู) ส่วนเสริมจะมีแถบเครื่องมือยอดนิยมที่ระบุส่วนเสริมและแสดงการ์ด โดยพื้นฐานแล้วจะเป็น "หน้า" ของ UI ของส่วนเสริม

ส่วนเสริมของ Google Workspace จะอิงตามการ์ด

ข้อมูลการประชุม

ชุดข้อมูลที่ Google ปฏิทินต้องการเพื่ออนุญาตให้ผู้ใช้สร้างและ เข้าร่วมการประชุมของบุคคลที่สามที่เปิดใช้ส่วนเสริมของ Google Workspace หรือส่วนเสริมการประชุมในปฏิทิน

ดูข้อมูลเพิ่มเติมในข้อมูลการประชุม

โซลูชันการประชุม

การนําเสนอการประชุมของบุคคลที่สามที่สร้างขึ้นจาก Google ปฏิทินโดยใช้ส่วนเสริมของ Google Workspace หรือส่วนเสริมการประชุมในปฏิทิน

โปรดดูข้อมูลเพิ่มเติมในโซลูชันการประชุม

บริบท

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

การเรียกตามบริบท

แนวทางปฏิบัติสําหรับกําหนดทริกเกอร์ที่จะเริ่มทํางานเมื่อผู้ใช้เข้าสู่บริบทเฉพาะ เช่น เมื่อเปิดชุดข้อความอีเมลใน Gmail การเรียกตามบริบท ทําให้ส่วนเสริมของคุณระบุ UI ที่เกี่ยวข้องกับบริบทนั้นได้ ระบบจะกําหนดค่าทริกเกอร์ตามบริบทในโปรเจ็กต์สคริปต์ส่วนเสริมไฟล์ Manifest และเป็นทริกเกอร์ไฟล์ Manifest ประเภทหนึ่ง

ส่วนเสริมเอดิเตอร์

ชุดส่วนเสริมประเภทเดิมซึ่งอนุญาตเฉพาะส่วนขยายของ Google เอกสาร ชีต ฟอร์ม หรือสไลด์ ส่วนเสริมเอดิเตอร์ไม่ได้อิงตามการ์ด แต่เป็นข้อมูลที่จําเป็นสําหรับนักพัฒนาซอฟต์แวร์ในการสร้าง UI จาก HTML และ CSS ดิบ ส่วนเสริมเอดิเตอร์แต่ละรายการจะ ขยายแอปพลิเคชันโฮสต์ได้เพียงรายการเดียว

ดูรายละเอียดเพิ่มเติมได้ที่ส่วนเสริมของผู้แก้ไข

ออบเจ็กต์เหตุการณ์

ออบเจ็กต์ JSON ที่สร้างขึ้นโดยอัตโนมัติเมื่อมีการขอหน้าแรก เมื่อส่วนเสริมเข้าสู่บริบทที่จําเป็นต่อการโต้ตอบ หรือเป็นผลจากการโต้ตอบของผู้ใช้กับวิดเจ็ตในอินเทอร์เฟซส่วนเสริม เมื่อสร้างแล้ว ระบบจะส่งออบเจ็กต์เหตุการณ์ไปยังฟังก์ชันทริกเกอร์หรือฟังก์ชันเรียกกลับที่ระบุ วัตถุประสงค์ของอ็อบเจ็กต์เหตุการณ์คือการส่งข้อมูลจากสภาพแวดล้อมฝั่งไคลเอ็นต์ (เช่น ข้อมูลที่ป้อนลงในวิดเจ็ตอินเทอร์เฟซส่วนเสริม) ไปยังโค้ดฝั่งเซิร์ฟเวอร์ของส่วนเสริม ซึ่งสามารถดําเนินการกับข้อมูลนั้นได้และส่งคืนการตอบกลับที่เหมาะสม

ดูรายละเอียดเพิ่มเติมได้ที่ออบเจ็กต์เหตุการณ์

ส่วนเสริม Gmail

ส่วนเสริมที่ขยายเฉพาะ Gmail ส่วนเสริม Gmail จะอิงตามการ์ด รายละเอียดการทํางาน พฤติกรรม และรายละเอียดการพัฒนาที่ใช้สร้างส่วนเสริม Gmail ส่วนใหญ่จะเหมือนกับรายละเอียดที่ใช้สร้างส่วนเสริมของ Google Workspace

โปรดดูข้อมูลเพิ่มเติมที่ส่วนเสริมของ Gmail และดูการอัปเกรดส่วนเสริมที่เผยแพร่แล้วเพื่อดูข้อมูลเกี่ยวกับวิธีแปลงส่วนเสริม Gmail เป็นส่วนเสริมของ Google Workspace

หน้าแรก

การ์ด UI รูทของส่วนเสริม หน้าแรกจะปรากฏขึ้นเมื่อผู้ใช้เปิดส่วนเสริม และปล่อยให้ส่วนเสริมแสดงเนื้อหานอกบริบทเฉพาะได้ (เช่น เมื่อผู้ใช้ดูชุดข้อความอีเมลใน Gmail แต่ไม่ได้เปิด) คุณจะกําหนดลักษณะและการทํางานของหน้าแรกส่วนเสริมเหมือนกับการ์ดอื่นๆ ได้

ดูข้อมูลเพิ่มเติมได้ที่หน้าแรก

โฮสต์หรือแอปพลิเคชันโฮสต์

แอปพลิเคชัน Google Workspace ที่ใช้ส่วนเสริม Google Workspace จะขยาย เช่น Gmail หรือ Google ปฏิทิน

อิงตาม HTML

ส่วนเสริมที่มีการกําหนดอินเทอร์เฟซผู้ใช้โดยใช้ HTML และ CSS แทนบริการการ์ดในตัวของ Apps Script เฉพาะส่วนเสริมสําหรับเอดิเตอร์เก่าๆ ที่ใช้ HTML เท่านั้น

ไฟล์ Manifest

ไฟล์ JSON ที่แนบมากับโครงการ Apps Script ไฟล์ Manifest ใช้ในการกําหนดข้อมูลโปรเจ็กต์ที่สคริปต์ต้องทํางานอย่างถูกต้อง สําหรับส่วนเสริมของ Google Workspace ไฟล์ Manifest จะใช้เพื่อระบุโฮสต์ที่ส่วนเสริมสามารถขยายและใส่การตั้งค่าการควบคุม UI บางอย่างได้

ทริกเกอร์ไฟล์ Manifest

ทริกเกอร์ที่กําหนดไว้ในไฟล์ Manifest ของโปรเจ็กต์ เช่น ทริกเกอร์หน้าแรกหรือทริกเกอร์ตามบริบท ทริกเกอร์ไฟล์ Manifest จะใช้เพื่อสร้างและแสดงการ์ดใหม่โดยเฉพาะเมื่อมีการขอหน้าแรกของส่วนเสริม หรือส่วนเสริมเข้าสู่บริบทที่ต้องอัปเดตการแสดงผล

ทริกเกอร์ไฟล์ Manifest แตกต่างจากทริกเกอร์อื่นๆ ใน Apps Script เนื่องจากในตัว (เช่น ทริกเกอร์แบบง่าย) และสร้างไม่ได้โดยใช้แบบเป็นโปรแกรมด้วยบริการสคริปต์ของ Apps Script (เช่น ทริกเกอร์ที่ติดตั้งได้)

การ์ดที่ไม่ใช่บริบท

การ์ดที่แสดงเนื้อหาเมื่อผู้ใช้อยู่นอกบริบท เช่น เมื่อดูชุดข้อความอีเมลใน Gmail แต่ไม่ได้เปิดการ์ด หน้าแรกเป็นการ์ดที่ไม่ใช่บริบท

ส่วนทางด้านขวาของ UI ของโฮสต์ที่มี UI ส่วนเสริมของ Google Workspace ปรากฏอยู่ Gmail และส่วนเสริมของเครื่องมือแก้ไขจะกําหนดแถบด้านข้างได้เช่นกัน

ทริกเกอร์

เงื่อนไขและการตอบกลับเหตุการณ์อัตโนมัติที่กําหนดโดยโปรเจ็กต์หรือส่วนเสริมของ Apps Script ทริกเกอร์จะเริ่มทํางานเมื่อเหตุการณ์ที่เกี่ยวข้องเกิดขึ้น (เช่น เมื่อเปิดส่วนเสริม) และทําให้ฟังก์ชัน Apps Script ที่ระบุ (ฟังก์ชันทริกเกอร์) ทํางานโดยอัตโนมัติ สําหรับส่วนเสริมของ Google Workspace ฟังก์ชันทริกเกอร์มักจะสร้างการ์ดใหม่เพื่อควบคุมส่วนต่างๆ ของ UI ส่วนเสริมที่จะแสดง เหตุการณ์บางประเภทเท่านั้นที่ทริกเกอร์ได้

ดูทริกเกอร์ส่วนเสริมสําหรับข้อมูลเพิ่มเติม

ฟังก์ชันทริกเกอร์

ฟังก์ชัน Apps Script ในโปรเจ็กต์ที่ปฏิบัติการให้ตอบสนองต่อทริกเกอร์ที่เริ่มทํางาน

วิดเจ็ต

องค์ประกอบ UI เช่น ปุ่ม ช่องข้อความ หรือช่องทําเครื่องหมาย การ์ดสร้างขึ้นจากลําดับออบเจ็กต์ของวิดเจ็ต ซึ่งกําหนดโดยบริการการ์ดในตัวของ Apps Script

ดูข้อมูลเพิ่มเติมได้ที่วิดเจ็ต

ฟังก์ชันเครื่องจัดการวิดเจ็ต

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

ดูฟังก์ชันเครื่องจัดการวิดเจ็ตสําหรับข้อมูลเพิ่มเติม