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

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

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

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

HTTP

Apps Script

เลือกชื่อที่แสดง รูปโปรไฟล์ และคำอธิบายสำหรับแอป 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 แล้วระบุรหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์

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

      • ADDED_TO_SPACE: ผู้ใช้เพิ่มแอป Chat ในการสนทนากลุ่มหรือพื้นที่ทำงาน หรือติดตั้งแอป Chat สําหรับการรับส่งข้อความแบบ 1:1
      • MESSAGE: ผู้ใช้ส่งข้อความไปยังแอป 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 ให้ทำดังนี้

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