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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      • หากต้องการใช้บริการ HTTP ให้เลือก URL ของปลายทาง HTTP แล้วระบุ URL
      • หากต้องการใช้โปรเจ็กต์ Google Apps Script ให้เลือก Apps Script แล้วระบุรหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์

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

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

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

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

  4. ไม่บังคับ: ในส่วนบันทึก ให้เลือกช่องทำเครื่องหมายบันทึกข้อผิดพลาดไปยัง Logging เพื่อใช้ 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
  • แอปแชทจะไม่ใช้ชื่อและโลโก้ที่คุณกำหนดค่า สำหรับแอปพลิเคชันอื่นๆ ของ Google Workspace ในออบเจ็กต์ addons.common ของไฟล์ Manifest
  • สำหรับส่วนเสริมที่เผยแพร่ใน Google Workspace Marketplace คุณจะบันทึกฉบับร่างของการเปลี่ยนแปลงใดๆ ในการตั้งค่าการกำหนดค่า Google Chat API ไม่ได้ หลังจากอัปเดตและบันทึกการตั้งค่าการกำหนดค่า Chat API แล้ว ผู้ใช้เดิมทั้งหมดจะใช้แอป Chat ที่อัปเดตได้ หากต้องการอัปเดตข้อมูลใน Marketplace คุณสามารถสร้างฉบับร่าง ก่อนส่งการเปลี่ยนแปลง

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

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