แนวทางปฏิบัติแนะนำ

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

แนวทางปฏิบัติแนะนำโดยทั่วไป

เราขอแนะนำให้คุณทำตามแนวทางปฏิบัติที่ดีที่สุดต่อไปนี้สำหรับส่วนเสริมทั้งหมดที่เพิ่งพัฒนา

กำหนดการเป็นเจ้าของส่วนเสริมก่อนเริ่ม

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

ขยายการใช้งาน Google Workspace ไม่ต้องทำซ้ำ

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

จำกัดขอบเขตให้แคบ

เมื่อกำหนดขอบเขตอย่างชัดแจ้ง ให้เลือกชุดขอบเขตที่ให้สิทธิ์น้อยที่สุดเสมอ ตัวอย่างเช่น อย่าให้ส่วนเสริมเข้าถึงปฏิทินของผู้ใช้อย่างเต็มรูปแบบโดยใช้ขอบเขต https://www.googleapis.com/auth/calendar หากส่วนเสริมต้องการสิทธิ์เข้าถึงแบบอ่านเพียงอย่างเดียว สำหรับสิทธิ์การเข้าถึงระดับอ่านอย่างเดียว ให้ใช้ขอบเขต https://www.googleapis.com/auth/calendar.readonly

หลีกเลี่ยงการพึ่งพาไลบรารีมากเกินไป

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

เวลาในการตอบสนองที่อธิบายไว้ข้างต้นจะมีผลกับโปรเจ็กต์ Apps Script ที่ใช้เป็นไลบรารีฝั่งเซิร์ฟเวอร์เท่านั้น คุณสามารถใช้ไลบรารี JavaScript ฝั่งไคลเอ็นต์อย่าง jQuery ได้อย่างอิสระและไม่มีปัญหาเวลาในการตอบสนองนี้

แนวทางปฏิบัติแนะนำสำหรับส่วนเสริมของเอดิเตอร์

แนวทางปฏิบัติแนะนำต่อไปนี้ใช้กับส่วนเสริม Editor เท่านั้น}

วาง HTML ของอินเทอร์เฟซและ JavaScript ฝั่งไคลเอ็นต์ในไฟล์สคริปต์ของตัวเอง

คุณสร้างไฟล์สคริปต์ได้หลายไฟล์ในโปรเจ็กต์ Apps Script คุณจะจัดการส่วนเสริมที่ซับซ้อนได้ง่ายขึ้นหากวาง HTML และ JavaScript ที่กําหนดแถบด้านข้างและกล่องโต้ตอบของส่วนเสริมในไฟล์สคริปต์ที่มีไว้สำหรับส่วนเสริมโดยเฉพาะ

ทดสอบอย่างละเอียดในโหมดการให้สิทธิ์ต่างๆ

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