อัปเกรดส่วนเสริมเดิมของ Gmail และปฏิทิน

ดูข้อมูลเพิ่มเติมได้ที่ฉันจะอัปเกรดส่วนเสริมของ Editor ได้ไหม

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

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

หมายเหตุ: หากคุณไม่อัปเกรดส่วนเสริมของ Gmail และส่วนเสริมการประชุมของปฏิทิน ระบบจะอัปเกรดโดยอัตโนมัติเป็นส่วนเสริมของ Google Workspace ที่มีหน้าแรกทั่วไป คุณไม่จําเป็นต้องเปลี่ยนแปลงข้อมูลหรือโค้ดของนักพัฒนาแอป และส่วนเสริมจะพร้อมใช้งานในแอปพลิเคชันโฮสต์เดิมเท่านั้น ใน Google Workspace Marketplace ส่วนเสริมที่อัปเกรดโดยอัตโนมัติจะแสดงอยู่ในส่วน "ใช้ได้กับ Gmail" หรือ "ใช้ได้กับปฏิทิน" โดยจะมีข้อมูลผลิตภัณฑ์ การติดตั้ง และผู้ใช้เดิมอยู่

ขั้นตอนที่ 1: ทำสำเนาโปรเจ็กต์ Apps Script ของส่วนเสริม

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

1. เปิดโปรเจ็กต์ Apps Script ของส่วนเสริม Gmail หรือส่วนเสริมการประชุมในปฏิทินที่มีอยู่
2. คลิกภาพรวม ทางด้านซ้าย
3. คลิก "ทำสำเนา" ทางด้านขวา
4. คลิกการตั้งค่าโปรเจ็กต์ > เปลี่ยนโปรเจ็กต์ทางด้านซ้าย
5. คลิกหมายเลขโปรเจ็กต์ GCP
6. ป้อนหมายเลขโปรเจ็กต์เดียวกันกับที่เชื่อมโยงกับโปรเจ็กต์ Apps Script ของส่วนเสริมที่เผยแพร่แล้ว
7. คลิกตั้งค่าโปรเจ็กต์

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

ขั้นตอนที่ 2: ผสานรวมส่วนเสริม Google Workspace

คุณต้องออกแบบและติดตั้งใช้งานฟีเจอร์ส่วนเสริมของ Google Workspace ที่ต้องการเพิ่มลงในส่วนเสริม

1. วางแผนว่าควรแสดงเนื้อหาใดในการ์ดหน้าแรกของส่วนเสริม และควรปรากฏใน Gmail, ปฏิทิน, ไดรฟ์ หรือทั้ง 3 โฮสต์ร่วมกันหรือไม่ หากต้องการหน้าแรกในโฮสต์มากกว่า 1 แห่ง ให้เลือกว่าจะใช้หน้าแรกเดียวกันหรือต้องการการ์ดหน้าแรกที่กำหนดเองสำหรับแต่ละโฮสต์
2. ในโปรเจ็กต์ Apps Script ของส่วนเสริมที่คัดลอกมา ให้สร้างการ์ดหน้าแรกด้วยฟังก์ชัน homepageTrigger อย่าลืมใส่ฟังก์ชันหรือตรรกะสนับสนุนที่จำเป็นในการควบคุมอินเทอร์เฟซหน้าแรกใหม่

3. ลองเพิ่มการ์ดตามบริบทที่ทริกเกอร์โดยการกระทำของผู้ใช้ เช่น การเปิดชุดข้อความของ Gmail หรือกิจกรรมในปฏิทิน

   ข้อควรระวัง: ส่วนเสริมที่อัปเกรดแล้วจะได้รับค่ารหัสสำหรับข้อความ Gmail ที่แตกต่างจากส่วนเสริมของ Gmail การเปลี่ยนแปลงนี้จะมีผลกับส่วนเสริมที่อัปเกรดแล้วซึ่งใช้ messageId เป็นคีย์ในพื้นที่เก็บข้อมูลถาวรเท่านั้น หากจำเป็น คุณยังคงรับค่ารหัสเดิมได้ด้วย Gmail API เมธอด messages().get() ของ Gmail API จะยอมรับทั้งค่ารหัสใหม่และเก่า แต่จะแสดงผลเฉพาะค่ารหัสเก่า

4. อัปเดตการเข้าถึงออบเจ็กต์เหตุการณ์ในส่วนเสริม (ในฟังก์ชันการเรียกกลับของวิดเจ็ตหรือในฟังก์ชันทริกเกอร์ตามบริบท) เพื่อใช้โครงสร้างออบเจ็กต์เหตุการณ์ที่อัปเดตแล้ว โครงสร้างใหม่ยังคงมีช่องออบเจ็กต์เหตุการณ์เดียวกันกับที่ใช้โดยส่วนเสริมการประชุมของ Gmail และปฏิทิน แต่ช่องเดิมเหล่านั้นเลิกใช้งานแล้วและจะถูกนำออกในที่สุด

ขั้นตอนที่ 3: อัปเดตไฟล์ Manifest ของส่วนเสริม

วิธีการจัดเก็บข้อมูลการกําหนดค่าในโครงสร้างไฟล์ Manifest ของส่วนเสริม Google Workspace มีการเปลี่ยนแปลงอย่างมากจากโครงสร้างที่ส่วนเสริม Gmail และส่วนเสริมการประชุมของปฏิทินใช้ เมื่ออัปเกรดส่วนเสริม คุณต้องอัปเดตช่องไฟล์ Manifest ของโปรเจ็กต์ Apps Script ของส่วนเสริมตามตารางด้านล่าง คุณต้องอัปเดตพร็อพเพอร์ตี้ย่อยที่เกี่ยวข้องทั้งหมดไปยังพร็อพเพอร์ตี้ addOns ใหม่

อย่าลืมอัปเดตช่อง oauthScopes ของไฟล์ Manifest ด้วยหากจำเป็นเพื่อให้สอดคล้องกับสิทธิ์ที่จําเป็นสําหรับส่วนเสริมที่อัปเดต

ดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ Manifest ของส่วนเสริม Google Workspace ได้ที่ไฟล์ Manifest

ส่วนเสริม Gmail

ฟิลด์ไฟล์ Manifest ต้นฉบับ	ขอให้ดำเนินการ
gmail.composeTrigger	ย้ายไปที่ addOns.gmail.composeTrigger
gmail.contextualTriggers[]	ย้ายรายการไปยัง addOns.gmail.contextualTriggers[]
gmail.logoUrl	ย้ายไปที่ addOns.common.logoUrl
gmail.name	ย้ายไปที่ addOns.common.name
gmail.openLinkUrlPrefixes[]	ย้ายรายการไปยัง addOns.common.openLinkUrlPrefixes[]
gmail.primaryColor	ย้ายไปที่ addOns.common.layoutProperties.primaryColor
gmail.secondaryColor	ย้ายไปที่ addOns.common.layoutProperties.secondaryColor
gmail.universalActions[]	ย้ายรายการไปยัง addOns.common.universalActions[]
gmail.universalActions[].text	ย้ายช่อง gmail.universalActions[].text แต่ละช่องไปยังช่อง addOns.common.universalActions[].label ที่เกี่ยวข้อง
gmail.useLocalFromApp	ย้ายไปที่ addOns.common.useLocaleFromApp

ส่วนเสริมการประชุมของปฏิทิน

ฟิลด์ไฟล์ Manifest ต้นฉบับ	ขอให้ดำเนินการ
calendar.createSettingsUrlFunction	ย้ายไปที่ addOns.calendar.createSettingsUrlFunction
calendar.conferenceSolution[]	ย้ายไปที่ addOns.calendar.conferenceSolution[]
calendar.logoUrl	ย้ายไปที่ addOns.common.logoUrl
calendar.name	ย้ายไปที่ addOns.common.name

ขั้นตอนที่ 4: ทดสอบส่วนเสริมที่อัปเกรด

หากต้องการทดสอบส่วนเสริมที่อัปเกรดแล้วก่อนเผยแพร่ โปรดดูการทดสอบส่วนเสริมของ Google Workspace

ขั้นตอนที่ 5: ขอรับการตรวจสอบส่วนเสริมที่อัปเกรด

ส่วนเสริม Google Workspace ทั้งหมด ไม่ว่าจะเป็นส่วนเสริมที่อัปเกรดหรือสร้างขึ้นใหม่ จะต้องได้รับอนุมัติก่อนจึงจะแสดงใน Google Workspace Marketplace ได้

ทำตามขั้นตอนต่อไปนี้เพื่อส่งส่วนเสริมเข้ารับการตรวจสอบ

1. ตรวจสอบว่าส่วนเสริมเป็นไปตามข้อกำหนดในการเผยแพร่ส่วนเสริมทั้งหมด

2. สร้างการติดตั้งที่มีเวอร์ชันของส่วนเสริม Google Workspace (ในโปรเจ็กต์ Apps Script ใหม่) โดยใช้เวอร์ชันโค้ดที่ต้องการเผยแพร่ อย่าพยายามเผยแพร่โดยใช้การทําให้ใช้งานได้

3. หากเพิ่มขอบเขตใหม่ขณะอัปเกรดส่วนเสริม คุณต้องขอการยืนยัน OAuth ตัวอย่างเช่น หากส่วนเสริม Gmail ใช้ขอบเขตใหม่ของไดรฟ์หรือปฏิทินในเวอร์ชันส่วนเสริมของ Google Workspace คุณต้องส่งขอบเขตใหม่เหล่านั้นเพื่อรับการยืนยัน การยืนยันมักจะใช้เวลา 2-3 วันจึงจะเสร็จสมบูรณ์ ดังนั้นโปรดเริ่มกระบวนการตั้งแต่เนิ่นๆ ตรวจสอบว่าส่วนเสริมได้รับการยืนยันแล้วก่อนดำเนินการต่อในขั้นตอนที่ 6

ขั้นตอนที่ 6: ทำให้ส่วนเสริมที่อัปเกรดแล้วพร้อมใช้งาน

1. เปิด SDK ของ Google Workspace Marketplace

2. คลิกการกําหนดค่าทางด้านซ้าย แผงนี้มีแบบฟอร์มสำหรับให้ข้อมูลเกี่ยวกับส่วนเสริม

3. อัปเดตคำอธิบายแบบย่อ คำอธิบายแบบละเอียด และภาพหน้าจอของข้อมูลผลิตภัณฑ์ให้สอดคล้องกับฟังก์ชันการทำงานใหม่ของส่วนเสริม Google Workspace

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

   ข้อควรระวัง: การอัปเกรดส่วนเสริมเป็นส่วนเสริมของ Google Workspace ด้วยวิธีนี้เป็นกระบวนการแบบครั้งเดียวที่ยกเลิกไม่ได้

5. หากคุณเพิ่มขอบเขตใหม่ไปยังส่วนเสริม Google Workspace โปรดตรวจสอบว่าได้เพิ่มขอบเขตเหล่านั้นลงในส่วนขอบเขต OAuth 2.0 ในหน้าการกําหนดค่า ขอบเขตที่แสดงในส่วนนั้นควรตรงกับขอบเขตที่แสดงในไฟล์ Manifest ของส่วนเสริมทุกประการ

6. ตรวจสอบว่าข้อมูลที่ป้อนในแบบฟอร์มถูกต้อง จากนั้นคลิกบันทึกการเปลี่ยนแปลง

หากมีข้อสงสัยหรือพบปัญหาระหว่างกระบวนการอัปเกรดส่วนเสริม Google Workspace นี้ โปรดติดต่อเรา

คำถามที่พบบ่อย

ต่อไปนี้คือคำถามที่พบบ่อยเกี่ยวกับการอัปเกรดส่วนเสริม

ฉันจะอัปเกรดส่วนเสริมสำหรับโปรแกรมแก้ไขได้ไหม

ส่วนเสริมส่วนใหญ่ของ Editor ย้ายไปยังส่วนเสริมของ Google Workspace ได้ แต่คุณจะอัปเกรดส่วนเสริมเหล่านี้เป็นส่วนเสริมของ Google Workspace ไม่ได้ง่ายๆ เหมือนกับส่วนเสริมของ Gmail และปฏิทิน

หากต้องการย้ายข้อมูลส่วนเสริมของ Editor ไปยังส่วนเสริมของ Google Workspace คุณต้องเขียน UI ของส่วนเสริมใหม่จาก HTML เป็นอินเทอร์เฟซที่อิงตามการ์ด และอัปเดตการจัดการ JavaScript ไปยัง Card Service

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

ฉันจะสร้างส่วนเสริม Google Workspace แยกต่างหากและเก็บส่วนเสริมที่มีอยู่ไว้ได้ไหม

คุณสร้างส่วนเสริม Google Workspace เพิ่มเติมภายใต้ชื่อแบรนด์อื่นได้ แต่เราไม่อนุญาตให้สร้างส่วนเสริมการประชุมแยกต่างหากสำหรับ Gmail หรือปฏิทินภายใต้ชื่อแบรนด์เดียวกับส่วนเสริม Google Workspace หากมีคำถามหรือต้องการขอการยกเว้น โปรดติดต่อเรา

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

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

ฉันจะอัปเกรดส่วนขยาย Chrome เป็นส่วนเสริมของ Google Workspace และโอนผู้ใช้ได้ไหม

ไม่ได้ คุณจะโอนผู้ใช้ การติดตั้ง และรีวิวของส่วนขยาย Chrome ไม่ได้ คุณต้องสร้างส่วนเสริม Google Workspace ใหม่และนำผู้ใช้ส่วนขยาย Chrome ไปยัง Google Workspace Marketplace

ฉันจะรวมส่วนเสริมหลายรายการไว้กับส่วนเสริม Google Workspace ได้ไหม

ดูแสดงรายการการผสานรวมแอปร่วมกัน