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

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

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

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

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

เปิดใช้ Marketplace SDK

เปิดใช้ Google Workspace Marketplace SDK ในโปรเจ็กต์ Google Cloud หากยังไม่ได้ดำเนินการ

เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใน Google Cloud Console

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

1. ในคอนโซล Google Cloud ให้ไปที่หน้าเลือกโปรเจ็กต์

   เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์

2. เลือกโปรเจ็กต์ Google Cloud ที่ต้องการใช้ หรือคลิกสร้างโปรเจ็กต์ แล้วทำตามวิธีการบนหน้าจอ หากสร้างโปรเจ็กต์ Google Cloud คุณอาจต้องเปิดการเรียกเก็บเงินสำหรับโปรเจ็กต์

เปิด SDK ของ Google Workspace Marketplace

คุณต้องเปิดใช้ API ของ Google ในโปรเจ็กต์ Google Cloud ก่อนจึงจะใช้ได้ คุณเปิด API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud โปรเจ็กต์เดียวได้

• เปิดใช้ SDK ของ Google Workspace Marketplace ในคอนโซล Google Cloud

  เปิดใช้ SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ใช้ข้อมูลจากส่วนก่อนหน้าเพื่อบันทึกการกำหนดค่าแอปใน SDK ของ Marketplace โดยทำดังนี้

1. ในคอนโซล Google Cloud ให้ไปที่หน้าการกำหนดค่า Marketplace SDK แล้วดำเนินการดังนี้

   ไปที่หน้าการกําหนดค่า SDK ของ Marketplace

2. กรอกข้อมูลในแต่ละส่วนตามที่คุณระบุไว้ในส่วนก่อนหน้า

3. คลิกบันทึก

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

   1. ไปที่แท็บ Analytics
   2. ป้อนรหัส Google Analytics
   3. คลิกบันทึก