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

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

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

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

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

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

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

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

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

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

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

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

เมื่อมีรายละเอียดแอป Chat แล้ว ให้เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์และกำหนดค่า 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 แล้วระบุ รหัสการติดตั้งใช้งานสำหรับโปรเจ็กต์
      • หากต้องการใช้ Agent ของ Dialogflow ให้เลือก Dialogflow แล้วเลือก Dialogflow CX หรือ Dialogflow ES จากนั้นระบุชื่อทรัพยากรของ Agent
      • หากต้องการใช้ Pub/Sub ให้เลือก Cloud Pub/Sub แล้วป้อนชื่อหัวข้อ

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

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

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

    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
  • แอป 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 เท่านั้น