กำหนดค่าแอปใน SDK ของ Google Workspace Marketplace

หน้านี้จะอธิบายวิธีใช้ SDK ของ Google Workspace Marketplace เพื่อกำหนดค่าและจัดการ แอปใน Google Workspace Marketplace

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

• ดูว่าแอปของคุณพร้อมให้บริการสําหรับองค์กร Google Workspace หนึ่งๆ หรือไม่ (แอปส่วนตัว) หรือสำหรับผู้ใช้ใน Marketplace ทั้งหมด ( สาธารณะ)
• ประเภทของผู้ใช้ Marketplace ที่สามารถติดตั้ง แอป
• แอปของคุณผสานกับแอปพลิเคชัน Google Workspace ใด
• ขอบเขต OAuth ที่แอปของคุณต้องใช้
• ข้อมูลเกี่ยวกับผู้ที่สร้างและดูแลแอป

ไม่ว่าคุณจะเผยแพร่ คุณต้องใช้ SDK ของ Google Workspace Marketplace เพื่อจัดการ แอปใน Marketplace

เปิดใช้ SDK ของ Google Workspace Marketplace

ในโปรเจ็กต์ Google Cloud เปิดใช้ SDK ของ Google Workspace Marketplace โดยทำดังนี้

1. เปิดคอนโซล Google Cloud
2. คลิกเลือกโปรเจ็กต์ที่ด้านบน หากโปรเจ็กต์ Google Cloud อื่น เปิดแล้ว ให้คลิกชื่อโปรเจ็กต์ Cloud เพื่อเปลี่ยน โปรเจ็กต์ที่อยู่ในระบบคลาวด์
3. เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของแอป แล้วคลิกเปิด
4. พิมพ์ Google Workspace Marketplace SDK ในแถบค้นหาที่ด้านบน แล้วกด Enter

5. เปิดหน้า SDK ของ Google Workspace Marketplace

   คำเตือน: ตรวจสอบว่าคุณเปิดใช้ SDK ของ Google Workspace Marketplace ไม่ใช่ API Google Workspace Marketplace API เป็นเครื่องมือที่แตกต่างออกไป บริการออกใบอนุญาตและเรียกเก็บเงินของ Google

6. หากยังไม่ได้เปิดใช้ SDK ของ Google Workspace Marketplace ให้คลิกเปิดใช้

ระบุการตั้งค่าของแอป

ข้อมูลอ้างอิงต่อไปนี้อธิบายการตั้งค่าที่มีในแอป หน้าการกำหนดค่าของ SDK ของ Google Workspace Marketplace

เลือกผู้ที่จะดูและติดตั้งแอปของคุณได้

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

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

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

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

ดูวิธีที่ผู้ดูแลระบบจัดการการเข้าถึง ตลาดกลาง โปรดดู เอกสารความช่วยเหลือสำหรับผู้ดูแลระบบ Marketplace

การตั้งค่าระดับการเข้าถึงแอป

คำเตือน: เมื่อคุณเลือกตัวเลือกการเปิดเผยและบันทึกการกำหนดค่าแอป คุณจะเปลี่ยนการเลือกในภายหลังไม่ได้

คุณจะเห็นตัวเลือกระดับการเข้าถึงแอปหากใช้ Google Workspace (บัญชีที่สร้างโดยองค์กรของที่ทำงานหรือโรงเรียน) หากคุณ โดยใช้บัญชีผู้ใช้ทั่วไป (บัญชีที่ลงท้ายด้วย "@gmail.com") คุณจะสามารถ เผยแพร่แบบสาธารณะ

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

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

หากต้องการจำกัดประเทศและภูมิภาคที่แอปพร้อมให้บริการ คุณก็ตั้งค่าในส่วนการเผยแพร่ สร้างข้อมูลผลิตภัณฑ์ใน Store

การตั้งค่าการติดตั้งแอป

การตั้งค่าการติดตั้งจะกำหนดว่าผู้ใช้หรือผู้ดูแลระบบ Workspace จะติดตั้งได้หรือไม่ แอปจากหน้าข้อมูลผลิตภัณฑ์ใน Store ใน Google Workspace Marketplace

หมายเหตุ: สำหรับแอป Google Chat คุณสามารถเลือกได้เฉพาะบุคคลธรรมดา + ผู้ดูแลระบบเท่านั้น ติดตั้งเนื่องจากผู้ใช้แต่ละรายสามารถค้นพบและติดตั้งแอปใน Chat ได้ จาก Google Chat โดยตรง ดูรายละเอียดเกี่ยวกับวิธีการติดตั้งได้ที่ การเผยแพร่แอป Google Chat

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

การติดตั้งทั่วไปและการตั้งค่าการมองเห็น

ตารางต่อไปนี้สรุปตัวเลือกการกำหนดค่าแอปที่พบบ่อยบางส่วนสำหรับ การติดตั้งและระดับการเข้าถึง:

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

ระบุวิธีที่แอปของคุณผสานรวมกับแอปพลิเคชัน Google Workspace

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

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

ส่วนเสริม Google Workspace (Apps Script)

หากต้องการเผยแพร่ส่วนเสริมของ Google Workspace คุณต้องระบุส่วนเสริม รหัสการทำให้ใช้งานได้ หากต้องการค้นหารหัสการทำให้ใช้งานได้ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิดส่วนเสริม Google Workspace ใน Apps Script Editor
2. คลิก ทำให้ใช้งานได้ > จัดการการทำให้ใช้งานได้
3. คลิกคัดลอกใต้รหัสการทำให้ใช้งานได้

ส่วนเสริม Google Workspace (รันไทม์สำรอง)

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

1. ในหน้าการกำหนดค่าแอปในส่วน "ส่วนเสริมของ Google Workspace" คลิก ทำให้ใช้งานได้โดยใช้ทรัพยากรการทำให้ใช้งานได้บนระบบคลาวด์ > เลือกการทำให้ใช้งานได้
2. เลือกการทำให้ใช้งานได้ที่ต้องการเผยแพร่
3. คลิกเลือก

ส่วนเสริมเครื่องมือแก้ไข (เอกสาร ชีต สไลด์ ฟอร์ม)

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

หากต้องการค้นหารหัสสคริปต์ของโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิดส่วนเสริมในเครื่องมือแก้ไข Apps Script
2. คลิกการตั้งค่าโปรเจ็กต์ทางด้านซ้าย
3. ในส่วน "รหัส" คัดลอกรหัสสคริปต์

หากต้องการค้นหาเวอร์ชัน ให้ทำตามขั้นตอนต่อไปนี้

1. เปิดส่วนเสริมในเครื่องมือแก้ไข Apps Script
2. ที่ด้านขวาบน ให้คลิกทำให้ใช้งานได้ > จัดการการทำให้ใช้งานได้
3. หมายเลขเวอร์ชันจะอยู่ในส่วน "การกําหนดค่า"

แอป Google Chat

หากต้องการเผยแพร่แอป Google Chat คุณต้องกำหนดค่า Google Chat API โปรดดู การเผยแพร่ แอป

แอปไดรฟ์

หากต้องการเผยแพร่แอปไดรฟ์ คุณต้องเปิดใช้และกำหนดค่า Drive API

เว็บแอป

ในการเผยแพร่เว็บแอป คุณต้องระบุ Universal Nav URL ซึ่งเป็น URL ที่ ชี้ไปที่เว็บแอปจากเมนูแอป Google เว็บแอปของคุณต้องอยู่ในเวอร์ชันที่ใช้งานจริงและทำงานได้อย่างสมบูรณ์

เมื่อกรอกข้อมูลในหน้าข้อมูลผลิตภัณฑ์ใน Store คุณต้องระบุไอคอนเพิ่มเติม ขนาด 96x96 และ 48x48 พิกเซล

หากคุณสร้างแอปพลิเคชันเว็บใน Apps Script เพื่อให้ URL การนำทาง โปรดทำตามขั้นตอนต่อไปนี้

1. เปิดส่วนเสริม Google Workspace ใน Apps Script Editor
2. คลิก ทำให้ใช้งานได้ > การทำให้ใช้งานได้ใหม่
3. ในส่วน "เลือกประเภท" คลิกเว็บแอป
4. กรอกตัวเลือกแล้วคลิกทำให้ใช้งานได้
5. คลิกคัดลอก

ระบุระดับการเข้าถึงที่แอปของคุณต้องการ

ในส่วนขอบเขต OAuth ให้ระบุรายการขอบเขต OAuth ทั้งหมดที่แอปของคุณ ต้องการ ขอบเขต OAuth ที่คุณป้อนที่นี่ควรตรงกับข้อมูลที่แสดงใน หน้าจอขอความยินยอม OAuth และไฟล์ Manifest ของ Apps Script หากมี

หากคุณรวมการผสานรวมแอปมากกว่า 1 รายการ โปรดตรวจสอบว่าคุณได้เพิ่มขอบเขตจาก แต่ละรายการลงในหน้าการกำหนดค่าแอป Google Workspace Marketplace SDK และความยินยอม OAuth บนหน้าจอ

ใช้ขอบเขตที่แคบที่สุดเท่าที่จะเป็นไปได้เสมอ (เช่น อย่าใส่แบบเต็ม ขอบเขตไดรฟ์ หากคุณต้องการแค่ขอบเขตแบบอ่านอย่างเดียว)

สำหรับโปรเจ็กต์สคริปต์ Apps โปรดดู ขอบเขต เพื่อดูรายละเอียดเพิ่มเติม

ให้ข้อมูลเกี่ยวกับนักพัฒนาแอป

กรอกข้อมูลติดต่อและรายละเอียดอื่นๆ ในส่วนข้อมูลนักพัฒนาแอป ฟิลด์เหล่านี้จะปรากฏบนแท็ก ข้อมูลผลิตภัณฑ์ใน Store

ช่อง
สถานะผู้ค้า	เนื่องด้วยกฎหมายคุ้มครองผู้บริโภค ผู้บริโภคที่อยู่ในยุโรป เขตเศรษฐกิจยุโรป (EEA) ต้องได้รับแจ้งว่าผู้ขายใน Google Workspace Marketplace เป็นผู้ค้าหรือ บุคคลที่ไม่ใช่ผู้ค้า: ผู้ค้า - ผู้ค้าคือบุคคลที่ทำหน้าที่ตามวัตถุประสงค์ที่เกี่ยวข้อง การค้า ธุรกิจ งานฝีมือ หรืออาชีพ หรือในชื่อ หรือ ในนามของผู้ค้า ไม่ใช่ผู้ค้า - ผู้ที่ไม่ใช่ผู้ค้า (ผู้บริโภค) คือบุคคลที่ดำเนินการเพื่อให้ วัตถุประสงค์ที่ไม่เป็นมืออาชีพ หากไม่ระบุ ระบบจะระบุว่า "ไม่ได้ระบุสถานะผู้ค้า" ปรากฏบนแอปของคุณ ข้อมูลผลิตภัณฑ์ใน Store
ที่อยู่จัดส่งของนักพัฒนาแอป	ต้องระบุสำหรับผู้ค้า ไม่เก็บรวบรวมสำหรับผู้ที่ไม่ใช่ผู้ค้า สถานที่ตั้งของธุรกิจ ป้อนที่อยู่ทางไปรษณีย์ที่ถูกต้องซึ่งคุณ สามารถติดต่อได้
ชื่อนักพัฒนาแอป	ชื่อที่จะแสดงในฐานะผู้เขียนแอป ถ้าคุณเป็นผู้ค้า ระบุชื่อซื้อขายหรือชื่อตามกฎหมายของคุณ
URL ของเว็บไซต์นักพัฒนาแอป	เว็บไซต์ที่อธิบายว่าคุณ (หรือองค์กรของคุณ) เป็น
อีเมลของนักพัฒนาแอป	อีเมลที่จะใช้เป็นผู้ติดต่อ ตอนนี้ ไม่รวมอยู่ในข้อมูลแอปของคุณ ตรวจสอบว่าอีเมลนี้ไม่เกิน วันที่ที่ใช้: หาก Google ต้องการติดต่อนักพัฒนาแอป เช่น ในช่วง กระบวนการตรวจสอบแอป หากต้องการส่งความคิดเห็นจากส่วนเสริมของ Editor หาก URL ของรายงานปัญหาไม่ถูกต้อง ที่มีให้ในหน้าข้อมูลผลิตภัณฑ์ใน Store
URL ของเว็บไซต์แอปพลิเคชัน	ไม่บังคับ เว็บไซต์ที่อธิบายแอปของคุณเพิ่มเติม

บันทึกการตั้งค่าการกำหนดค่าแอปใน Google Workspace Marketplace SDK

ใช้ข้อมูลจากส่วนก่อนหน้า บันทึกการกำหนดค่าแอปของคุณใน SDK ของ Google Workspace Marketplace ดังนี้

1. เปิด SDK ของ Google Workspace Marketplace
2. ไปที่แท็บการกำหนดค่าแอป
3. กรอกข้อมูลในแต่ละส่วนตามที่คุณระบุไว้ใน ส่วนก่อนหน้า
4. คลิกบันทึก
5. (ไม่บังคับ) คุณรับการวิเคราะห์เกี่ยวกับการใช้งานแอปได้ ใน Google Analytics โดยเพิ่มรหัส Google Analytics ใน SDK ของ Google Workspace Marketplace
   1. ไปที่แท็บ Analytics
   2. ป้อนรหัส Google Analytics
   3. คลิกบันทึก