อภิธานศัพท์

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

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

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

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

การ์ด

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

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

อิงตามบัตร

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

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

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

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

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

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

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

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

บริบท

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

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

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

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

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

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

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

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

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

ส่วนเสริม 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 และเครื่องมือแก้ไขยังกำหนดแถบด้านข้างได้อีกด้วย

ชิปอัจฉริยะ

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

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

ทริกเกอร์

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

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

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

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

วิดเจ็ต

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

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

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

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

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