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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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

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

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

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

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

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

  4. อัปเดตการเข้าถึงออบเจ็กต์เหตุการณ์ในส่วนเสริม (ในฟังก์ชันเรียกกลับของวิดเจ็ตหรือในฟังก์ชันทริกเกอร์ตามบริบท) เพื่อใช้โครงสร้างออบเจ็กต์เหตุการณ์ที่อัปเดต โครงสร้างใหม่จะยังคงมีช่องออบเจ็กต์เหตุการณ์เดียวกันกับที่ส่วนเสริมของ Gmail และปฏิทินใช้อยู่ แต่ระบบจะไม่เลิกใช้งานช่องเดิมเหล่านั้นและจะถูกนําออกในที่สุด

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

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

อย่าลืมอัปเดตช่องไฟล์ Manifest oauthScopes ตามที่จําเป็นเพื่อให้สอดคล้องกับสิทธิ์ที่ส่วนเสริมที่อัปเดตต้องใช้

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

ทําตามขั้นตอนต่อไปนี้เพื่อส่งส่วนเสริมเข้ารับการตรวจสอบ

  1. ตรวจสอบว่าส่วนเสริมเป็นไปตามข้อกําหนดการเผยแพร่ส่วนเสริมทั้งหมด

  2. สร้างการติดตั้งใช้งานเวอร์ชันใหม่ของ Google Workspace ส่วนเสริม (ในโปรเจ็กต์ Apps Script ใหม่) โดยใช้เวอร์ชันของโค้ดที่ต้องการเผยแพร่ อย่าพยายามเผยแพร่เนื้อหา ด้วยการใช้ศีรษะ

  3. หากคุณเพิ่มขอบเขตใหม่ในขณะที่อัปเกรดส่วนเสริม คุณต้องขอรับการยืนยัน OAuth เช่น หากส่วนเสริม Gmail ใช้ขอบเขตของไดรฟ์หรือปฏิทินใหม่ใน Google Workspace เวอร์ชันส่วนเสริม คุณต้องส่งขอบเขตใหม่เหล่านั้นเพื่อการยืนยัน การยืนยันมักใช้เวลา 2-3 วันในการดําเนินการ ดังนั้นให้เริ่มกระบวนการนี้โดยเร็วที่สุด ตรวจสอบว่าส่วนเสริมได้รับการยืนยันแล้วก่อนดําเนินการต่อในขั้นตอนที่ 6

ขั้นตอนที่ 6: ทําให้ส่วนเสริมที่อัปเกรดพร้อมใช้งาน

  1. เปิด Google Workspace Marketplace SDK

  2. คลิก Configuration ทางด้านซ้าย แผงนี้มีแบบฟอร์มที่คุณให้ข้อมูลเกี่ยวกับส่วนเสริม

  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 ตลาดกลาง

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

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