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

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

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

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

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

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

ขยายขอบเขตการใช้งาน 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 ได้อย่างอิสระโดยไม่พบเวลาในการตอบสนองนี้

แนวทางปฏิบัติแนะนำสำหรับส่วนเสริมของโปรแกรมแก้ไข

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

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

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

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

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