กำหนดค่าแอป Google Chat

หน้านี้อธิบายวิธีกำหนดค่าและทำให้แอป Google Chat ใช้งานได้ในฐานะส่วนเสริมของ Google Workspace

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

ข้อกำหนดเบื้องต้น

HTTP

• บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
• สร้างโปรเจ็กต์ Google Cloud
• กำหนดค่าหน้าจอขอความยินยอม OAuth
• เปิดใช้ Google Workspace API ต่อไปนี้
  • Google Chat API
  • Google Workspace Add-ons API
    คุณไม่สามารถใช้ Google Workspace Add-ons API เพื่อสร้างและจัดการการติดตั้งใช้งานแอป Chat โปรดดูรายละเอียดที่หัวข้อข้อจำกัดและปัญหาที่ทราบ
• ปลายทาง HTTP ที่โฮสต์สถาปัตยกรรมบริการสำหรับแอปแชท

Apps Script

• บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
• สร้างโปรเจ็กต์ Google Cloud
• กำหนดค่าหน้าจอขอความยินยอม OAuth
• เปิดใช้ Google Chat API
• สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน และเปิดบริการแชทขั้นสูง
• กำหนดค่า Chat ในไฟล์ Manifest โดยเพิ่มออบเจ็กต์ addons.chat และขอบเขตที่จำเป็น (oauthScopes) หรือคำนำหน้า HTTPS URL (urlFetchWhitelist)

เลือกชื่อที่แสดง รูปโปรไฟล์ และคำอธิบายสำหรับแอป Chat

ชื่อ รูปโปรไฟล์ และคำอธิบายของแอป Chat จะแสดงต่อผู้ใช้ใน UI ของ Chat ผู้ใช้จะเห็นหรือใช้ข้อมูลนี้ในการโต้ตอบกับแอป Chat ดังนี้

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

คุณต้องเตรียมข้อมูลต่อไปนี้ก่อนกำหนดค่าแอป Chat

ช่อง	คำอธิบาย	รูปแบบ
ชื่อแอป	ชื่อที่แสดงสำหรับแอป Chat	อักขระที่เป็นตัวอักษรและตัวเลขคละกันไม่เกิน 25 ตัว
URL ของรูปโปรไฟล์	รูปภาพที่แสดงเป็นรูปโปรไฟล์ของแอป Chat	URL ของ HTTPS ที่ชี้ไปยังรูปภาพกราฟิกสี่เหลี่ยมจัตุรัส (PNG หรือ JPEG) ขนาดที่แนะนำคือ 256 x 256 พิกเซลขึ้นไป
คำอธิบาย	คำอธิบายสั้นๆ เกี่ยวกับวัตถุประสงค์ของแอป Chat	อักขระที่เป็นตัวอักษรและตัวเลขคละกันไม่เกิน 40 ตัว

ในส่วนต่อไปนี้ คุณจะระบุข้อมูลนี้ในการตั้งค่าการกําหนดค่าใน Chat API

กำหนดค่าแอป Chat ในคอนโซล Google Cloud

เมื่อคุณมีรายละเอียดแอป Chat แล้ว ให้เปิดโปรเจ็กต์ Google Cloud และกำหนดค่า Chat API โดยทำดังนี้

1. ในคอนโซล Google Cloud ให้ไปที่หน้า Chat API แล้วคลิกหน้าการกําหนดค่า

   ไปที่หน้าการกําหนดค่า Chat API

2. ในส่วนข้อมูลแอปพลิเคชัน ให้กรอกข้อมูลในช่องชื่อแอป URL รูปโปรไฟล์ และคําอธิบาย

3. ในส่วนฟีเจอร์แบบอินเทอร์แอกทีฟ ให้คลิกเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟไปที่ตำแหน่งเปิด แล้วทำตามขั้นตอนต่อไปนี้

   1. ในส่วนฟังก์ชันการทำงาน ให้เลือกช่องทำเครื่องหมายอย่างน้อย 1 ช่องเพื่อให้ผู้ใช้ติดตั้งและใช้แอป Chat ได้

      • รับข้อความแบบ 1:1: ผู้ใช้สามารถติดตั้งและใช้แอป Chat เพื่อส่งข้อความในพื้นที่เฉพาะระหว่างผู้ใช้กับแอป Chat

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

   2. ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือกสถาปัตยกรรมที่ต้องการใช้รับออบเจ็กต์เหตุการณ์จาก Chat

      • หากต้องการใช้บริการ HTTP ให้เลือก URL ปลายทาง HTTP แล้วระบุ URL
      • หากต้องการใช้โปรเจ็กต์ Google Apps Script ให้เลือก Apps Script แล้วระบุรหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์
      คำเตือน: หากป้อนรหัสการติดตั้งใช้งาน Apps Script ไว้แล้ว โปรเจ็กต์ในระบบคลาวด์จะเชื่อมต่อกับส่วนเสริม Google Workspace ที่มีอยู่ หากคุณอัปเดตรหัสการติดตั้งใช้งานใน Chat API ระบบจะอัปเดตรหัสดังกล่าวสําหรับส่วนเสริมและอาจส่งผลต่อข้อมูลผลิตภัณฑ์ใน Google Workspace Marketplace หากต้องการตรวจสอบการกำหนดค่าส่วนเสริม โปรดดูหัวข้อกำหนดค่าแอปใน SDK ของ Google Workspace Marketplace ในเอกสารประกอบของ Google Workspace Marketplace

   3. ไม่บังคับ: หากต้องการรับออบเจ็กต์เหตุการณ์ไปยังปลายทางหรือฟังก์ชันมากกว่า 1 รายการ ให้ไปที่การตั้งค่าขั้นสูง > ทริกเกอร์ แล้วระบุหรืออัปเดตฟังก์ชันการเรียกกลับสำหรับทริกเกอร์แชทต่อไปนี้

      หมายเหตุ: สำหรับ Apps Script หากคุณไม่อัปเดตทริกเกอร์ คุณต้องใช้ฟังก์ชันการเรียกกลับที่เกี่ยวข้องซึ่งแสดงในส่วนนี้ (เช่น onMessage, onAddedToSpace และ onRemovedFromSpace)
      • ADDED_TO_SPACE: ผู้ใช้เพิ่มแอป Chat ในการสนทนากลุ่มหรือพื้นที่ทำงาน หรือติดตั้งแอป Chat สําหรับการรับส่งข้อความแบบ 1:1
      • ข้อความ: ผู้ใช้ส่งข้อความไปยังแอป Chat เช่น ส่งข้อความส่วนตัวไปยังแอป Chat หรือ @พูดถึงแอป Chat ในพื้นที่ทำงานที่มีผู้ใช้หลายคน
      • REMOVED_FROM_SPACE: ผู้ใช้ถอนการติดตั้งหรือนำแอป Chat ออกจากพื้นที่ทำงาน

   4. ไม่บังคับ: เพิ่มฟีเจอร์อื่นๆ แบบอินเทอร์แอกทีฟ เช่น คำสั่งขีดกลางหรือตัวอย่างลิงก์

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

4. ไม่บังคับ: ในส่วนบันทึก ให้เลือกช่องทําเครื่องหมายบันทึกข้อผิดพลาดไปยังการบันทึกเพื่อใช้ Google Cloud Logging ดูข้อมูลเพิ่มเติมได้ที่ค้นหาบันทึกข้อผิดพลาดสำหรับแอป Chat ในเอกสารประกอบของ Chat API

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

หลังจากบันทึกการกำหนดค่าแล้ว ทุกคนที่คุณระบุไว้ในการตั้งค่าระดับการเข้าถึงของ Chat API จะติดตั้ง ทดสอบ หรือใช้แอป Chat ได้ หากต้องการเริ่มทดสอบและแก้ไขข้อบกพร่องของแอป Chat โปรดดูทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับแอป Google Chat ในเอกสารประกอบของ Chat API

สิ่งที่ควรทราบเกี่ยวกับส่วนเสริม Google Workspace ที่มีอยู่

แอป Chat ต้องมีการกำหนดค่าที่แตกต่างจากส่วนเสริม Google Workspace ที่ขยายแอปพลิเคชันอื่นๆ ของ Google Workspace หากส่วนเสริมขยายแอปพลิเคชันอื่นๆ ของ Google Workspace โปรดพิจารณาข้อกำหนดต่อไปนี้สำหรับการกำหนดค่าแอป Chat

• ทั้งผู้ใช้ทั่วไปและผู้ดูแลระบบ Google Workspace ต้องติดตั้งส่วนเสริมของคุณจาก Marketplace ได้ คุณกำหนดค่าการตั้งค่าการติดตั้งเหล่านี้ใน SDK ของ Google Workspace Marketplace
• แอป Chat จะไม่ใช้ชื่อและโลโก้ที่คุณกำหนดค่าไว้สำหรับแอปพลิเคชัน Google Workspace อื่นๆ ในออบเจ็กต์ addons.common ของ manifest
• สําหรับส่วนเสริมที่เผยแพร่ใน Google Workspace Marketplace คุณจะบันทึกฉบับร่างของการเปลี่ยนแปลงการตั้งค่าการกําหนดค่า Google Chat API ไม่ได้ หลังจากอัปเดตและบันทึกการตั้งค่าการกําหนดค่า Chat API แล้ว แอป Chat ที่อัปเดตจะพร้อมให้บริการแก่ผู้ใช้ปัจจุบันทุกคน หากต้องการอัปเดตข้อมูลผลิตภัณฑ์ใน Marketplace คุณสามารถสร้างฉบับร่างก่อนส่งการเปลี่ยนแปลง

• หากคุณสร้างส่วนเสริมโดยใช้ Apps Script ให้ทำดังนี้

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

• หากคุณสร้างส่วนเสริมโดยใช้บริการ HTTP ให้ยกเว้นรายละเอียดการกำหนดค่าแอป Chat ในไฟล์ Manifest และการติดตั้งใช้งานที่คุณสร้างโดยใช้ Google Workspace Add-ons API การใช้งาน HTTP ที่คุณระบุใน SDK ของ Google Workspace Marketplace จะใช้กับแอปพลิเคชันอื่นๆ ของ Google Workspace เท่านั้น

หัวข้อที่เกี่ยวข้อง

• หากต้องการจัดการสิทธิ์เข้าถึง Chat API โปรดดูหัวข้อกำหนดค่า Google Chat API ในเอกสารประกอบของ Google Chat API
• ทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับแอป Google Chat
• เผยแพร่แอป Google Chat