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

สิ่งดีๆ ที่คุณทําได้คือ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อฉันจะอัปเกรดส่วนเสริมของผู้แก้ไขได้ไหม

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

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

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

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

1. เปิดโปรเจ็กต์ส่วนเสริม Gmail หรือส่วนเสริมการประชุมการประชุมที่มีอยู่ในปฏิทิน Apps Script
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 นี้ โปรดติดต่อเรา

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

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

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

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

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

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