อภิธานศัพท์

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

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

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

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

Card

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

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

แบบบัตร

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

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

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

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

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

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

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

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

บริบท

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

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

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

ส่วนเสริมของตัวแก้ไข

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

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

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

ออบเจ็กต์ 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

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

โปรดดูข้อมูลเพิ่มเติมที่แสดงตัวอย่างลิงก์ใน Google เอกสาร

ไฟล์ 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

ดูข้อมูลเพิ่มเติมในวิดเจ็ต

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

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

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