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

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

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

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

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

คุณสามารถย้ายส่วนเสริมส่วนใหญ่ของเครื่องมือแก้ไขไปยังส่วนเสริมของ 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 ได้ไหม

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