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

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

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

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

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

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

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

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

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

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

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

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

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