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

วันที่

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

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

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

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

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

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

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

โปรดอย่าลืมอัปเดตไฟล์ Manifest oauthScopes ในช่องเป็น เพื่อแสดงสิทธิ์ที่ส่วนเสริมที่อัปเดตของคุณต้องการ

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ 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 ครั้งนี้ โปรดติดต่อเรา

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

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

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

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

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

บริการบางอย่างในส่วนเสริม 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 ได้ไหม

โปรดดูแสดงรายการการผสานรวมแอปเข้าด้วยกัน