กำหนดค่า Google Chat API

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

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

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

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

• บัญชี Google Workspace แบบ Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
• สร้างโปรเจ็กต์ Google Cloud
• กำหนดค่าหน้าจอขอความยินยอม OAuth
• เปิดใช้ Google Chat API

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

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

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

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

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

หากต้องการโต้ตอบกับแอปใน Chat ผู้ใช้จะเห็นหรือใช้ข้อมูลนี้ในลักษณะต่อไปนี้ด้วย

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

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

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

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

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

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

3. ไม่บังคับ: จากเมนูไวยากรณ์มาร์กอัป ให้เลือกไวยากรณ์มาร์กอัปเริ่มต้น (Markdown หรือ Chat) สำหรับข้อความของแอปใน Chat ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความและวิธีที่ Chat กำหนดไวยากรณ์มาร์กอัปสำหรับคำขอ API ได้ที่หัวข้อจัดรูปแบบข้อความ

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

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

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

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

      • หากต้องการใช้บริการ HTTP ให้เลือก HTTP endpoint URL แล้วระบุ URL
      • หากต้องการใช้โปรเจ็กต์ Google Apps Script ให้เลือก Apps Script และระบุรหัสการติดตั้งใช้งานสำหรับโปรเจ็กต์
      • หากต้องการใช้ตัวแทน Dialogflow ให้เลือก Dialogflow แล้วเลือก Dialogflow CX หรือ Dialogflow ES จากนั้นระบุชื่อทรัพยากรของตัวแทน
      • หากต้องการใช้ Pub/Sub ให้เลือก Cloud Pub/Sub แล้วป้อนชื่อหัวข้อ

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

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

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

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

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

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

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

ข้อควรพิจารณาสำหรับส่วนเสริม 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 และการติดตั้งใช้งานที่คุณสร้างโดยใช้ API ส่วนเสริมของ Google Workspace การติดตั้งใช้งาน HTTP ที่คุณระบุใน SDK ของ Google Workspace Marketplace จะใช้สำหรับแอปพลิเคชัน Google Workspace อื่นๆ เท่านั้น

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

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

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

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

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

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