อภิธานศัพท์

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

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

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

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

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

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

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