แนวทางปฏิบัติที่ดี

ปรับปรุงข้อมูลผู้ใช้ ประสบการณ์โดยรวมได้ โดยปฏิบัติตามคู่มือ การออกแบบส่วนเสริม Google Meet

แนวทางปฏิบัติแนะนำสำหรับการให้สิทธิ์

ขอแนะนำให้ใช้แนวทางปฏิบัติแนะนำต่อไปนี้สำหรับ ส่วนเสริม Google Meet ที่ต้องมีการตรวจสอบสิทธิ์หรือการให้สิทธิ์

ใช้ Google Sign-In

ผู้ใช้ส่วนเสริม Google Workspace จำนวนมากจะลงชื่อเข้าใช้ Google มาก่อนแล้ว เข้าร่วมการประชุม ดังนั้นการมี Google Sign-In เป็นตัวเลือก สามารถช่วยให้ผู้ใช้ของคุณได้รับจำนวนคลิก หลายครั้ง เมื่อดำเนินการ ขั้นตอนการลงชื่อเข้าใช้

เปิดหน้าลงชื่อเข้าใช้ของบุคคลที่สามในหน้าต่างใหม่

นอกจาก Google Sign-In แล้ว แอปพลิเคชันของคุณอาจเสนอการลงชื่อเข้าใช้เพิ่มเติม และกลไกต่างๆ ในกรณีนี้ ให้ใช้หน้าต่างกล่องโต้ตอบแทนการเปิดหน้าลงชื่อเข้าใช้ใน แท็บใหม่ ด้วยวิธีนี้ ผู้ใช้จะยังคงเห็นและกลับไปที่ การโทรผ่าน Meet ซึ่งจะได้รับคลิกโดยรวมน้อยกว่า

ขอขอบเขตอย่างเหมาะสมสำหรับ Google APIs

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

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

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

แนวทางปฏิบัติแนะนำด้านการบำรุงรักษา

แนวทางปฏิบัติแนะนำต่อไปนี้มีไว้สำหรับการเขียนที่บำรุงรักษาได้ เว็บแอปพลิเคชันมากมาย แต่มีความสำคัญเป็นพิเศษเมื่อเขียน พบกับส่วนเสริม

ใช้ SDK ส่วนเสริมของ Google Meet เวอร์ชันล่าสุด

SDK ส่วนเสริมของ Meet ได้รับการอัปเดตเป็นประจำ SDK ปฏิบัติตาม การกำหนดเวอร์ชันทางความหมาย หากต้องการค้นหาเวอร์ชันล่าสุด ให้ทำดังนี้

  • เมื่อใช้ gstatic: SDK เวอร์ชันล่าสุดอยู่ใน gstatic URL ได้จากวิธีการใช้ SDK
  • เมื่อใช้ npm: เรียกใช้ npm update @googleworkspace/meet-add-ons จากภายใน ไดเรกทอรีที่มี package.json สำหรับเว็บไซต์ที่โฮสต์ส่วนเสริม Meet

สร้างโปรเจ็กต์การทดลองใช้ Google Cloud

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

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

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

  • การทดลองใช้: เผยแพร่เวอร์ชันทดลองใช้แบบส่วนตัว เพื่อให้ทุกคนในองค์กรช่วยทำการทดสอบได้
  • การพัฒนา: คลิกติดตั้งภายในคอลัมน์การดำเนินการเพื่อติดตั้ง พบกับส่วนเสริมเวอร์ชันพัฒนาสำหรับบัญชีของคุณโดยเฉพาะ

เขียนการทดสอบ

ก่อนทำให้ส่วนเสริม Meet ใช้งานได้ในการพัฒนา ขอแนะนำให้เขียนการทดสอบ 1 หน่วย การทดสอบ 1 หน่วยของคุณควรมีข้อมูลต่อไปนี้

  • จำลอง SDK ส่วนเสริมของ Meet แล้วตรวจสอบว่า ส่วนเสริม Meet จะเรียกใช้ฟังก์ชันของ SDK ตามที่คาดไว้
  • การทดสอบ 1 หน่วยฟังก์ชันการทำงานทั้งหมดที่ไม่ได้เกี่ยวข้องกับ SDK ของ ส่วนเสริมพร้อมเฟรมเวิร์กการทดสอบเว็บที่คุณต้องการ

แนวทางปฏิบัติแนะนำเกี่ยวกับประสบการณ์ของผู้ใช้

แนวทางปฏิบัติแนะนำต่อไปนี้จะช่วยสร้างส่วนเสริม Meet ใช้งานง่ายและปรับแต่งมากขึ้น

จัดการสถานะเริ่มต้นทั้งหมดในแผงด้านข้าง

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

ปิดแผงด้านข้างเมื่อไม่ได้ใช้งาน

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

โปรโมตส่วนเสริม Meet ผ่านการแชร์หน้าจอ

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