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

หมายเหตุ: ขณะนี้คุณยังอัปเกรดส่วนเสริมของโปรแกรมแก้ไขเป็นส่วนเสริมของ Google Workspace โดยตรงไม่ได้ ดูข้อมูลเพิ่มเติมได้ที่ฉันจะอัปเกรดส่วนเสริมของ 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 นี้ โปรดติดต่อเรา

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

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

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

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

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

บริการบางอย่างในส่วนเสริม Editor ที่มีอยู่อาจไม่พร้อมใช้งานใน Card Service ตัวอย่างเช่น หากส่วนเสริมของ Editor มีเครื่องมือเลือกไฟล์ จะไม่มีเครื่องมือที่เทียบเท่าจาก Card Service สำหรับส่วนเสริมของ Google Workspace

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

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

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

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

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

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

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

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