อภิธานศัพท์

คำต่อไปนี้ใช้ในเอกสารนี้

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

ส่วนเสริมประเภทพิเศษที่ใช้เพื่อให้ผู้ให้บริการการประชุมนำเสนอ ตัวเลือกการประชุมในกิจกรรมของ 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 แทนบริการการ์ดในตัวของ Apps Script มีเพียงส่วนเสริมของเครื่องมือแก้ไขรุ่นเก่า เท่านั้นที่ใช้ HTML

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

ทริกเกอร์ตัวอย่างลิงก์จะทำงานเมื่อผู้ใช้โต้ตอบกับ URL ของบุคคลที่สามหรือ 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

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

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

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

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