การอัปเกรดส่วนเสริมที่เผยแพร่แล้ว

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

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

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

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

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

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

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

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

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

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 ในขั้นตอนก่อนหน้า หากรหัสการทำให้ใช้งานได้ถูกต้อง รายการโฮสต์ที่รองรับจะปรากฏขึ้น

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

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

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

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

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

ฉันจะอัปเกรดส่วนเสริม Editor ได้ไหม

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

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

บริการบางอย่างในส่วนเสริม Editor ที่มีอยู่อาจไม่พร้อมใช้งานในบริการบัตร ตัวอย่างเช่น หากส่วนเสริม Editor ของคุณมีเครื่องมือเลือกไฟล์จะไม่มีเครื่องมือที่เทียบเท่าจากบริการการ์ดสําหรับส่วนเสริมของ 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 ได้ไหม

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