ติดตั้งและให้สิทธิ์ส่วนเสริม

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

ส่วนเอกสารประกอบนี้จะอธิบายวิธีที่ผู้ใช้สามารถติดตั้ง ให้สิทธิ์ และเริ่มใช้ส่วนเสริม

ติดตั้งส่วนเสริม

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

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

โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อเผยแพร่ส่วนเสริม

ให้สิทธิ์ส่วนเสริม

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

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

ให้สิทธิ์ส่วนเสริมที่เผยแพร่แล้ว

หลังจากติดตั้งส่วนเสริมที่เผยแพร่แล้ว ขั้นตอนการให้สิทธิ์จะเริ่มขึ้นทันที โดยทำดังนี้

  1. ระบบจะแจ้งให้คุณเลือกบัญชีที่จะติดตั้งส่วนเสริม
  2. จากนั้นคุณจะเห็นรายการการให้สิทธิ์ที่จําเป็นสําหรับการทํางานของส่วนเสริม เพื่อให้ทราบว่าส่วนเสริมพยายามทําอะไร โปรดตรวจสอบรายการนี้อย่างละเอียด และหากยังต้องการให้สิทธิ์ ให้คลิกอนุญาต ซึ่งจะเปิดใช้ส่วนเสริม
  3. ตอนนี้คุณเรียกใช้จากแอปพลิเคชันโฮสต์ที่ขยายได้แล้ว หากแอปพลิเคชันเปิดอยู่ในแท็บเบราว์เซอร์อยู่แล้ว คุณอาจต้องรีเฟรชแท็บก่อนส่วนเสริมจึงจะพร้อมใช้งาน

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

ให้สิทธิ์ส่วนเสริม Google Workspace ที่ไม่ได้เผยแพร่

การ์ดการให้สิทธิ์สำหรับส่วนเสริม

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

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

ให้สิทธิ์บริการที่ไม่ใช่ของ Google สำหรับส่วนเสริม Google Workspace

ส่วนเสริมของ Google Workspace อาจเชื่อมต่อกับบริการของบุคคลที่สามที่ต้องมีการให้สิทธิ์ ส่วนเสริม Google Workspace ที่เชื่อมต่อกับบริการดังกล่าวต้องใช้การดำเนินการ 2 อย่างแยกกันจากผู้ใช้ ดังนี้

  • การให้สิทธิ์ส่วนเสริมเองเมื่อติดตั้งหรือเริ่มใช้งานเป็นครั้งแรก
  • การอนุญาตให้เข้าถึงบริการที่ไม่ใช่ของ Google เป็นครั้งแรก

หากส่วนเสริม Google Workspace ที่คุณพัฒนาขึ้นจำเป็นต้องเข้าถึงบริการที่ไม่ใช่ของ Google โดยใช้ OAuth คุณต้องกำหนดค่าการเชื่อมต่อสำหรับบริการนั้นเมื่อสร้างส่วนเสริม

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเชื่อมต่อส่วนเสริมของ Google Workspace กับบริการของบุคคลที่สาม

ระบบการประชุมของบุคคลที่สาม

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

หากผู้ใช้พยายามสร้างการประชุมด้วยส่วนเสริมของคุณโดยไม่ลงชื่อเข้าใช้ เมธอด onCreateFunction ของโซลูชันการประชุมควรแสดงผลออบเจ็กต์ ConferenceData ที่มีออบเจ็กต์ ConferenceError ที่มี URL การตรวจสอบสิทธิ์

เมื่อได้รับออบเจ็กต์นี้ Google ปฏิทินจะสร้างปุ่มเข้าสู่ระบบใน UI การแก้ไขกิจกรรมซึ่งลิงก์กับ URL การตรวจสอบสิทธิ์ที่ส่วนเสริมระบุ จากนั้นผู้ใช้จะใช้ปุ่มนี้เพื่อเข้าสู่ระบบของบุคคลที่สามได้ก่อนที่จะใช้ส่วนเสริมต่อไป

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการจัดการการให้สิทธิ์โดยใช้ ConferenceError ได้ที่หัวข้อการสร้างการประชุมของบุคคลที่สาม

ให้สิทธิ์ส่วนเสริมของ Editor ที่ไม่ได้เผยแพร่

แนวทางปฏิบัติแนะนำคือทดสอบส่วนเสริมของ Editor ขณะที่พัฒนา ขั้นตอนการให้สิทธิ์จะเหมือนกับส่วนเสริม Editor ที่เผยแพร่ ยกเว้นว่าขั้นตอนดังกล่าวจะเริ่มขึ้นเมื่อคุณพยายามทดสอบส่วนเสริมเป็นครั้งแรก หากทดสอบส่วนเสริมเดียวกันอีกครั้งในภายหลัง ระบบจะไม่แจ้งให้คุณให้สิทธิ์อีก

ยกเลิกการให้สิทธิ์ส่วนเสริม

ในระหว่างการพัฒนาส่วนเสริม คุณอาจต้องการยกเลิกการให้สิทธิ์เพื่อให้ทดสอบขั้นตอนการให้สิทธิ์อีกครั้ง

คุณยกเลิกการให้สิทธิ์ส่วนเสริมได้โดยทำดังนี้

  1. เปิดคอนโซลความปลอดภัยของบัญชี
  2. ค้นหาและคลิกส่วนเสริมที่ต้องการยกเลิกการให้สิทธิ์
  3. คลิกนำสิทธิ์เข้าถึงออก

เมื่อเรียกใช้ส่วนเสริมอีกครั้งหลังจากยกเลิกการให้สิทธิ์แล้ว ระบบจะแสดงขั้นตอนการให้สิทธิ์อีกครั้ง

ถอนการติดตั้งส่วนเสริม

หากต้องการถอนการติดตั้งส่วนเสริมที่ติดตั้งจาก Google Workspace Marketplace โปรดดูหัวข้อถอนการติดตั้งแอปหรือส่วนเสริมใน Marketplace

หากต้องการถอนการติดตั้งส่วนเสริมที่ยังไม่ได้เผยแพร่ซึ่งสร้างใน Apps Script โปรดดูถอนการติดตั้งส่วนเสริมที่ยังไม่ได้เผยแพร่