หน้านี้จะอธิบายวิธีใช้ 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 โดยทำดังนี้
- เปิดคอนโซล Google Cloud
- คลิกเลือกโปรเจ็กต์ที่ด้านบน หากโปรเจ็กต์ Google Cloud อื่น เปิดแล้ว ให้คลิกชื่อโปรเจ็กต์ Cloud เพื่อเปลี่ยน โปรเจ็กต์ที่อยู่ในระบบคลาวด์
- เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของแอป แล้วคลิกเปิด
- พิมพ์
Google Workspace Marketplace SDK
ในแถบค้นหาที่ด้านบน แล้วกด Enter เปิดหน้า SDK ของ Google Workspace Marketplace
หากยังไม่ได้เปิดใช้ 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 Workspace Marketplace สำหรับผู้ดูแลระบบและผู้ที่ ไม่ได้เข้าสู่ระบบบัญชี Google ของตนเอง เลือกตัวเลือกนี้หากแอปของคุณ ต้องมีการติดตั้งโดเมน
การติดตั้งทั่วไปและการตั้งค่าการมองเห็น
ตารางต่อไปนี้สรุปตัวเลือกการกำหนดค่าแอปที่พบบ่อยบางส่วนสำหรับ การติดตั้งและระดับการเข้าถึง:
ผู้ใช้แอปเป้าหมาย | การตั้งค่าระดับการเข้าถึงแอป | การตั้งค่าการติดตั้งแอป | ใครสามารถติดตั้งแอปของฉันได้บ้าง | ใครใช้แอปของฉันได้บ้าง | |
---|---|---|---|---|---|
สำหรับแอปที่สร้างขึ้นเพื่อองค์กรที่ใช้ Google Workspace | |||||
ผู้ใช้บางรายในองค์กร | ส่วนตัวและไม่เป็นสาธารณะ | ติดตั้งโดยผู้ใช้และผู้ดูแลระบบ | ทุกคนในองค์กรที่มี URL ของข้อมูลแอป หากอนุญาต | ทุกคนในองค์กรที่มี URL ของข้อมูลแอป หากอนุญาต | |
องค์กรของคุณ | ส่วนตัว | ติดตั้งโดยผู้ใช้และผู้ดูแลระบบ | ทุกคนในองค์กรของคุณหากได้รับอนุญาต | ทุกคนในองค์กรของคุณหากได้รับอนุญาต | |
องค์กรของคุณ | ส่วนตัว | ผู้ดูแลระบบเท่านั้น | ผู้ดูแลระบบ | ผู้ใช้ที่ผู้ดูแลระบบติดตั้งแอปไว้ | |
สำหรับแอปที่ให้บริการแก่ผู้ใช้ภายนอกองค์กร Google Workspace ที่ระบุ | |||||
ผู้ใช้ในองค์กร Google Workspace | สาธารณะ | ผู้ดูแลระบบเท่านั้น | ผู้ดูแลระบบ | ผู้ใช้ที่ผู้ดูแลระบบติดตั้งแอปไว้ | |
ผู้ใช้ Google Workspace ทั้งหมด | สาธารณะ | ติดตั้งโดยผู้ใช้และผู้ดูแลระบบ |
|
|
ระบุวิธีที่แอปของคุณผสานรวมกับแอปพลิเคชัน Google Workspace
เลือกบริการ Google Workspace ที่ออกแบบมาเพื่อให้แอปหรือส่วนเสริมของคุณ ใช้งานด้วย เช่น ส่วนเสริม Google Workspace หรือ แอป Google Chat คุณต้องเลือกอย่างน้อย 1 ตัวเลือก ในบางกรณี คุณสามารถรวมการผสานรวมแอปหลายรายการไว้ในข้อมูลแอป โปรดดู ระบุรายชื่อการผสานรวมแอปเข้าด้วยกัน
คุณอาจต้องระบุข้อมูลเพิ่มเติมเกี่ยวกับการผสานรวมแอป ซึ่งขึ้นอยู่กับการผสานรวมแอปที่คุณเลือก และเปิดใช้ API ที่เกี่ยวข้องในโปรเจ็กต์ Google Cloud ของคุณ ดังต่อไปนี้ ตารางจะอธิบายการตั้งค่าเพิ่มเติมที่จําเป็นสําหรับแต่ละรายการ
ส่วนเสริม Google Workspace (Apps Script)
หากต้องการเผยแพร่ส่วนเสริมของ Google Workspace คุณต้องระบุส่วนเสริม รหัสการทำให้ใช้งานได้ หากต้องการค้นหารหัสการทำให้ใช้งานได้ ให้ทำตามขั้นตอนต่อไปนี้
- เปิดส่วนเสริม Google Workspace ใน Apps Script ของ Google
- คลิก ทำให้ใช้งานได้ > จัดการการทำให้ใช้งานได้
- คลิกคัดลอกใต้รหัสการทำให้ใช้งานได้
ส่วนเสริมของ Google Workspace (การทำให้ HTTP ใช้งานได้)
หากคุณสร้างส่วนเสริม Google Workspace โดยใช้ปลายทาง HTTP ให้ทำตามขั้นตอนต่อไปนี้เพื่อรับรหัสการทำให้ใช้งานได้จาก แหล่งข้อมูลการทำให้ Google Cloud ใช้งานได้
- ในหน้าการกำหนดค่าแอปในส่วน "ส่วนเสริมของ Google Workspace" คลิก ทำให้ใช้งานได้โดยใช้ทรัพยากรการทำให้ใช้งานได้บนระบบคลาวด์ > เลือกการทำให้ใช้งานได้
- เลือกการทำให้ใช้งานได้ที่ต้องการเผยแพร่
- คลิกเลือก
ส่วนเสริมเครื่องมือแก้ไข (เอกสาร ชีต สไลด์ ฟอร์ม)
หากต้องการเผยแพร่ส่วนเสริมเครื่องมือแก้ไข คุณต้องระบุ รหัสสคริปต์โปรเจ็กต์และเวอร์ชันที่คุณต้องการเผยแพร่
หากต้องการค้นหารหัสสคริปต์ของโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้
- เปิดส่วนเสริมในเครื่องมือแก้ไข Apps Script
- คลิกการตั้งค่าโปรเจ็กต์ทางด้านซ้าย
- ในส่วน "รหัส" คัดลอกรหัสสคริปต์
หากต้องการค้นหาเวอร์ชัน ให้ทำตามขั้นตอนต่อไปนี้
- เปิดส่วนเสริมในเครื่องมือแก้ไข Apps Script
- ที่ด้านขวาบน ให้คลิกทำให้ใช้งานได้ > จัดการการทำให้ใช้งานได้
- หมายเลขเวอร์ชันจะอยู่ในส่วน "การกําหนดค่า"
แอป Google Chat
หากต้องการเผยแพร่แอป Google Chat คุณต้องกำหนดค่า Google Chat API โปรดดู การเผยแพร่ แอป
แอปไดรฟ์
หากต้องการเผยแพร่แอปไดรฟ์ คุณต้องเปิดใช้และกำหนดค่า Drive API
เว็บแอป
ในการเผยแพร่เว็บแอป คุณต้องระบุ Universal Nav URL ซึ่งเป็น URL ที่ ชี้ไปที่เว็บแอปจากเมนูแอป Google
เว็บแอปของคุณต้องอยู่ในเวอร์ชันที่ใช้งานจริงและทำงานได้อย่างสมบูรณ์เมื่อกรอกข้อมูลในหน้าข้อมูลผลิตภัณฑ์ใน Store คุณต้องระบุไอคอนเพิ่มเติม ขนาด 96x96 และ 48x48 พิกเซล
หากคุณสร้างแอปพลิเคชันเว็บใน Apps Script เพื่อให้ URL การนำทาง โปรดทำตามขั้นตอนต่อไปนี้
- เปิดส่วนเสริม Google Workspace ใน Apps Script ของ Google
- คลิก ทำให้ใช้งานได้ > การทำให้ใช้งานได้ใหม่
- ในส่วน "เลือกประเภท" คลิกเว็บแอป
- กรอกตัวเลือกแล้วคลิกทำให้ใช้งานได้
- คลิกคัดลอก
ระบุระดับการเข้าถึงที่แอปของคุณต้องการ
ในส่วนขอบเขต OAuth ให้ระบุรายการขอบเขต OAuth ทั้งหมดที่แอปของคุณ ต้องการ ขอบเขต OAuth ที่คุณป้อนที่นี่ควรตรงกับข้อมูลที่แสดงใน หน้าจอขอความยินยอม OAuth และไฟล์ Manifest ของ Apps Script หากมี
หากคุณรวมการผสานรวมแอปมากกว่า 1 รายการ โปรดตรวจสอบว่าคุณได้เพิ่มขอบเขตจาก แต่ละรายการลงในหน้าการกำหนดค่าแอป Google Workspace Marketplace SDK และความยินยอม OAuth บนหน้าจอ
ใช้ขอบเขตที่แคบที่สุดเท่าที่จะเป็นไปได้เสมอ (เช่น อย่าใส่แบบเต็ม ขอบเขตไดรฟ์ หากคุณต้องการแค่ขอบเขตแบบอ่านอย่างเดียว)
สำหรับโครงการ Apps Script โปรดดู ขอบเขต เพื่อดูรายละเอียดเพิ่มเติม
ให้ข้อมูลเกี่ยวกับนักพัฒนาแอป
กรอกข้อมูลติดต่อและรายละเอียดอื่นๆ ในส่วนข้อมูลนักพัฒนาแอป ฟิลด์เหล่านี้จะปรากฏบนแท็ก ข้อมูลผลิตภัณฑ์ใน Store
ช่อง | |
---|---|
สถานะผู้ค้า |
เนื่องด้วยกฎหมายคุ้มครองผู้บริโภค ผู้บริโภคที่อยู่ในยุโรป เขตเศรษฐกิจยุโรป (EEA) ต้องได้รับแจ้งว่าผู้ขายใน Google Workspace Marketplace เป็นผู้ค้าหรือ บุคคลที่ไม่ใช่ผู้ค้า:
หากไม่ระบุ ระบบจะระบุว่า "ไม่ได้ระบุสถานะผู้ค้า" ปรากฏบนแอปของคุณ ข้อมูลผลิตภัณฑ์ใน Store |
ที่อยู่จัดส่งของนักพัฒนาแอป |
ต้องระบุสำหรับผู้ค้า ไม่เก็บรวบรวมสำหรับผู้ที่ไม่ใช่ผู้ค้า สถานที่ตั้งของธุรกิจ ป้อนที่อยู่ทางไปรษณีย์ที่ถูกต้องซึ่งคุณ สามารถติดต่อได้ |
ชื่อนักพัฒนาแอป | ชื่อที่จะแสดงในฐานะผู้เขียนแอป ถ้าคุณเป็นผู้ค้า ระบุชื่อซื้อขายหรือชื่อตามกฎหมายของคุณ |
URL ของเว็บไซต์นักพัฒนาแอป | เว็บไซต์ที่อธิบายว่าคุณ (หรือองค์กรของคุณ) เป็น |
อีเมลของนักพัฒนาแอป |
อีเมลที่จะใช้เป็นผู้ติดต่อ ตอนนี้ ไม่รวมอยู่ในข้อมูลแอปของคุณ ตรวจสอบว่าอีเมลนี้ไม่เกิน วันที่ - ระบบจะใช้วันที่:
|
URL ของเว็บไซต์แอปพลิเคชัน | ไม่บังคับ เว็บไซต์ที่อธิบายแอปของคุณเพิ่มเติม |
บันทึกการตั้งค่าการกำหนดค่าแอปใน Google Workspace Marketplace SDK
ใช้ข้อมูลจากส่วนก่อนหน้า บันทึกการกำหนดค่าแอปของคุณใน SDK ของ Google Workspace Marketplace ดังนี้
- เปิด SDK ของ Google Workspace Marketplace
- ไปที่แท็บการกำหนดค่าแอป
- กรอกข้อมูลในแต่ละส่วนตามที่คุณระบุไว้ใน ส่วนก่อนหน้า
- คลิกบันทึก
- (ไม่บังคับ) คุณรับการวิเคราะห์เกี่ยวกับการใช้งานแอปได้
ใน Google Analytics
โดยเพิ่มรหัส Google Analytics
ใน SDK ของ Google Workspace Marketplace
- ไปที่แท็บ Analytics
- ป้อนรหัส Google Analytics
- คลิกบันทึก