กำหนดค่า Google Chat API

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

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

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

หากต้องการเรียกใช้ Chat API คุณต้องตั้งค่าแอป Google Chat ด้วยข้อมูลต่อไปนี้

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

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

เช่น หากคุณเรียกใช้เมธอด spaces.create() ทาง Chat จะใส่ชื่อแอป Chat ไว้ในคำอธิบายของผู้ที่สร้างพื้นที่ทำงาน ดังที่แสดงในภาพต่อไปนี้

แอป Google Chat สร้างพื้นที่ทำงานให้กับผู้ใช้
รูปที่ 1 ข้อความระบุแหล่งที่มาที่ Chat แสดงเมื่อใช้เมธอด spaces.create() เพื่อสร้างพื้นที่ทำงานในนามของผู้ใช้

หากต้องการโต้ตอบกับแอปใน Chat ผู้ใช้สามารถดูหรือใช้ข้อมูลนี้ได้ด้วยวิธีต่อไปนี้

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

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

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

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

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

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

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

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

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

ให้สิทธิ์บุคคลอื่นในการกำหนดค่า Chat API

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

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

โดยที่ PROJECT_ID คือรหัสโปรเจ็กต์ Google Cloud ที่โฮสต์แอป Chat