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

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

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

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

คุณต้องติดตั้งส่วนเสริมก่อน จึงจะใช้ส่วนเสริมได้ เมื่อติดตั้งแล้ว ส่วนเสริมจะพร้อมใช้งานใน 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

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

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

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

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

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

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

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

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

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

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