ผู้ใช้ต้องติดตั้งและให้สิทธิ์ส่วนเสริมก่อน จึงจะเปิดและใช้งานได้ เนื่องจากขั้นตอนเหล่านี้เป็นส่วนแรกของประสบการณ์ของผู้ใช้ส่วนเสริม คุณจึงควรทำความเข้าใจขั้นตอนเหล่านี้ก่อนที่จะเริ่มสร้างส่วนเสริมของคุณเอง
ส่วนเอกสารประกอบนี้จะอธิบายวิธีที่ผู้ใช้ติดตั้ง ให้สิทธิ์ และเริ่มใช้ส่วนเสริมได้
ติดตั้งส่วนเสริม
คุณต้องติดตั้งส่วนเสริมก่อน จึงจะใช้ส่วนเสริมได้ เมื่อติดตั้งแล้ว ส่วนเสริมจะพร้อมใช้งานในแอปพลิเคชันโฮสต์ของ Google Workspace
คุณสามารถติดตั้งส่วนเสริมที่เผยแพร่แล้วได้จากแอปพลิเคชันโฮสต์ Google Workspace หรือจาก Google Workspace Marketplace ผู้ดูแลระบบโดเมนยังติดตั้งส่วนเสริมในนามของผู้ใช้จาก Google Workspace Marketplace ได้ด้วย นอกจากนี้ คุณยังติดตั้งส่วนเสริมที่ยังไม่ได้เผยแพร่ซึ่งกำลังพัฒนาอยู่เพื่อทดสอบได้ ก่อนที่จะใช้ส่วนเสริมที่ติดตั้งเป็นครั้งแรก คุณต้องให้สิทธิ์ก่อน
โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อเผยแพร่ส่วนเสริม
ให้สิทธิ์ส่วนเสริม
หลังจากติดตั้งส่วนเสริมแล้ว ส่วนเสริมจะพร้อมใช้งานในแอปพลิเคชันโฮสต์ของ Google Workspace ครั้งแรกที่ผู้ใช้พยายามใช้ส่วนเสริม แอปพลิเคชันโฮสต์จะแสดงการ์ดหรือกล่องโต้ตอบการให้สิทธิ์ การ์ดนี้จะอธิบายว่าส่วนเสริมต้องการสิทธิ์เพื่อทำสิ่งต่างๆ ให้กับผู้ใช้อย่างไร เช่น การเข้าถึงเนื้อหาของสเปรดชีตใน Google ชีตปัจจุบัน จากนั้นผู้ใช้สามารถให้สิทธิ์ดังกล่าว และอนุญาตให้ส่วนเสริมดำเนินการต่อได้ หากผู้ใช้ปฏิเสธการให้สิทธิ์ส่วนเสริม ก็จะใช้ส่วนเสริมไม่ได้
ส่วนเสริมเครื่องมือแก้ไขใช้โมเดลการให้สิทธิ์ที่แตกต่างจากส่วนเสริมของ Google Workspace เนื่องจากส่วนเสริม Editor ทำงานกับไฟล์ใน Google ไดรฟ์ โมเดลการให้สิทธิ์ของเครื่องมือแก้ไขจะกำหนดโหมดการให้สิทธิ์ต่างๆ ที่จะมีผลเมื่อมีการใช้ส่วนเสริมกับแต่ละไฟล์ เมื่อพัฒนา ส่วนเสริมเอดิเตอร์ คุณควรทำความเข้าใจโหมดต่างๆ และวิธีย้ายส่วนเสริมระหว่างโหมดต่างๆ
ให้สิทธิ์ส่วนเสริมที่เผยแพร่แล้ว
หลังจากติดตั้งส่วนเสริมที่เผยแพร่แล้ว ขั้นตอนการให้สิทธิ์จะเริ่มต้นทันทีดังนี้
- ระบบจะแจ้งให้เลือกบัญชีที่จะติดตั้งส่วนเสริม
- จากนั้นคุณจะเห็นรายการการให้สิทธิ์ที่ส่วนเสริมกำหนดให้ทำงาน เพื่อให้คุณทราบว่าต้องทำอะไร โปรดตรวจสอบรายการนี้โดยละเอียด และหากคุณยังคงต้องการให้สิทธิ์ ให้คลิกอนุญาต ซึ่งจะเป็นการเปิดใช้ส่วนเสริมสำหรับการใช้งาน
- ตอนนี้คุณสามารถเรียกใช้ได้จากแอปพลิเคชันโฮสต์ที่ขยายได้ หากเปิดแอปพลิเคชันไว้ในแท็บเบราว์เซอร์แล้ว คุณอาจต้องรีเฟรชแท็บนั้นก่อนจึงจะใช้งานส่วนเสริมได้
หากส่วนเสริมที่คุณติดตั้งได้รับการอัปเดตในภายหลังและต้องมีการให้สิทธิ์เพิ่มเติมซึ่งคุณยังไม่ได้ให้สิทธิ์ คุณจะได้รับแจ้งให้ให้สิทธิ์เหล่านั้นในครั้งต่อไปที่คุณใช้ส่วนเสริม
ให้สิทธิ์ส่วนเสริมของ 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 ขณะพัฒนาส่วนเสริมดังกล่าว ขั้นตอนการให้สิทธิ์เหมือนกับขั้นตอนสำหรับส่วนเสริมเครื่องมือแก้ไขที่เผยแพร่ เว้นแต่ว่าขั้นตอนนี้จะเริ่มต้นเมื่อคุณพยายามทดสอบส่วนเสริมเป็นครั้งแรก หากคุณทดสอบส่วนเสริมเดิมอีกครั้งในภายหลัง คุณจะไม่ได้รับข้อความแจ้งให้ให้สิทธิ์อีก
ยกเลิกการให้สิทธิ์ส่วนเสริม
ขณะพัฒนาส่วนเสริม การยกเลิกการให้สิทธิ์อาจเป็นประโยชน์เพื่อให้คุณทดสอบขั้นตอนการให้สิทธิ์อีกครั้งได้
คุณสามารถยกเลิกการให้สิทธิ์ส่วนเสริมได้โดยทำดังนี้
- เปิดคอนโซลความปลอดภัยของบัญชี
- ค้นหาและคลิกส่วนเสริมที่ต้องการยกเลิกการให้สิทธิ์
- คลิกนำสิทธิ์การเข้าถึงออก
เมื่อเรียกใช้ส่วนเสริมอีกครั้งหลังจากไม่ได้รับอนุญาต ระบบจะแสดงขั้นตอนการให้สิทธิ์อีกครั้ง