อภิธานศัพท์

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

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

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

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

การ์ด

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

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

อิงตามการ์ด

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

ส่วนเสริมของ Google Workspace เป็นแบบการ์ด

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

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

ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลการประชุม

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

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

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

บริบท

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

การทริกเกอร์ตามบริบท

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

ส่วนเสริมเครื่องมือแก้ไข

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

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

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

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

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

ส่วนเสริม Gmail

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

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

หน้าแรก

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

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

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

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

อิงตาม HTML

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

ทริกเกอร์ตัวอย่างลิงก์

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

ดูข้อมูลเพิ่มเติมที่หัวข้อแสดงตัวอย่างลิงก์ด้วยชิปอัจฉริยะ

ไฟล์ Manifest

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

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

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

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

การ์ดที่ไม่อิงตามบริบท

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

แถบด้านข้าง

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

ชิปอัจฉริยะ

ชิปอัจฉริยะคือการพูดถึงบุคคล ไฟล์ กิจกรรมในปฏิทิน หรือเอนทิตีอื่นๆ ภายในแอปพลิเคชัน Google Workspace เมื่อวางเมาส์เหนือชิป ผู้ใช้จะดูตัวอย่างเนื้อหาเพิ่มเติมเกี่ยวกับไฟล์หรือลิงก์ได้ด้วย เช่น เมื่อผู้ใช้วางเมาส์เหนือชิปของงานนำเสนอใน Google สไลด์ ก็จะเห็นภาพหน้าจอของสไลด์ เจ้าของงานนำเสนอ และข้อมูลว่าผู้ใช้เคยดูงานนำเสนอนั้นหรือไม่

คุณสามารถกำหนดค่าส่วนเสริมให้ใช้ชิปอัจฉริยะเพื่อแสดงตัวอย่างลิงก์สำหรับบริการของบุคคลที่สามหรือบริการที่ไม่ใช่ของ Google ดูหัวข้อดูตัวอย่างลิงก์ใน Google เอกสาร

ทริกเกอร์

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

ดูข้อมูลเพิ่มเติมได้ในทริกเกอร์ของส่วนเสริม

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

ฟังก์ชัน Apps Script ในโปรเจ็กต์ที่ทำงานเมื่อทริกเกอร์เริ่มทํางาน

วิดเจ็ต

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

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

ฟังก์ชันตัวแฮนเดิลวิดเจ็ต

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

ดูข้อมูลเพิ่มเติมได้ที่ฟังก์ชันตัวแฮนเดิลวิดเจ็ต