การเริ่มต้นแอปแชทใน Google Apps Script อย่างรวดเร็ว

สร้างแอป Google Chat ที่รับส่งข้อความได้โดยตรงและโต้ตอบด้วยการสะท้อนข้อความ

แผนภาพต่อไปนี้จะแสดงสถาปัตยกรรมและรูปแบบการรับส่งข้อความ

สถาปัตยกรรมของแอป Chat ที่ใช้งานร่วมกับ Apps Script

ในแผนภาพก่อนหน้านี้ ผู้ใช้ที่โต้ตอบกับแอปแชทของ Apps Script จะมีโฟลว์ข้อมูลดังต่อไปนี้

  1. ผู้ใช้ส่งข้อความไปยังแอปใน Chat ไม่ว่าจะเป็นข้อความส่วนตัวหรือในพื้นที่ใน Chat
  2. ตรรกะของแอป Chat ที่ใช้งานใน Apps Script ซึ่งอยู่ใน Google Cloud จะรับและประมวลผลข้อความ
  3. ตรรกะของแอป Chat อาจผสานรวมกับบริการของ Google Workspace เช่น ปฏิทินหรือชีต หรือบริการอื่นๆ ของ Google เช่น Google Maps หรือ YouTube ได้
  4. ตรรกะของแอป Chat จะส่งการตอบกลับไปยังบริการแอป Chat ใน Chat
  5. ระบบจะส่งคำตอบให้กับผู้ใช้

วัตถุประสงค์

  • ตั้งค่าสภาพแวดล้อมของคุณ
  • ตั้งค่าสคริปต์
  • เผยแพร่แอป Chat
  • ทดสอบแอป Chat

สิ่งที่ต้องดำเนินการก่อน

ตั้งค่าสภาพแวดล้อมของคุณ

เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในคอนโซล Google Cloud

หากยังไม่ได้เปิดโปรเจ็กต์ดังกล่าว ให้เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่คุณต้องการใช้สำหรับตัวอย่างนี้

  1. ในคอนโซล Google Cloud ให้ไปที่หน้าเลือกโปรเจ็กต์

    เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์

  2. เลือกโปรเจ็กต์ Google Cloud ที่ต้องการใช้ หรือคลิกสร้างโปรเจ็กต์แล้วทำตามวิธีการบนหน้าจอ หากสร้างโปรเจ็กต์ Google Cloud คุณอาจต้องเปิดการเรียกเก็บเงินสำหรับโปรเจ็กต์

เปิด Chat API

ก่อนใช้ Google APIs คุณต้องเปิดใช้ API เหล่านี้ในโปรเจ็กต์ Google Cloud คุณสามารถเปิด API ได้ตั้งแต่ 1 รายการขึ้นไปในโปรเจ็กต์ Google Cloud เดียว

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

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > หน้าจอขอความยินยอม OAuth

    ไปที่หน้าจอขอความยินยอม OAuth

  2. เลือกประเภทผู้ใช้เป็นภายใน แล้วคลิกสร้าง
  3. กรอกแบบฟอร์มการลงทะเบียนแอป แล้วคลิกบันทึกและดำเนินการต่อ

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

  5. ตรวจสอบสรุปการลงทะเบียนแอป หากต้องการเปลี่ยนแปลง ให้คลิกแก้ไข หากการลงทะเบียนแอปถูกต้องแล้ว ให้คลิกกลับไปที่หน้าแดชบอร์ด

ตั้งค่าสคริปต์

หากต้องการตั้งค่าสคริปต์ ให้ใช้เทมเพลตแล้วตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใน Apps Script

สร้างสคริปต์จากเทมเพลต

  1. ไปที่หน้าเริ่มต้นใช้งาน Apps Script
  2. คลิกเทมเพลตแอป Chat คุณอาจต้องเลื่อนลงเพื่อดูเทมเพลตนี้
  3. คลิกโปรเจ็กต์ที่ไม่มีชื่อ พิมพ์ Quickstart app แล้วคลิกเปลี่ยนชื่อ

คัดลอกหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > การตั้งค่า

    ไปที่ IAM และการตั้งค่าผู้ดูแลระบบ

  2. คัดลอกค่าในช่องหมายเลขโปรเจ็กต์

ตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของโปรเจ็กต์ Apps Script

  1. ในโปรเจ็กต์ Apps Script ของแอป Chat ให้คลิกการตั้งค่าโปรเจ็กต์ ไอคอนสำหรับการตั้งค่าโปรเจ็กต์
  2. ในส่วนโครงการ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโครงการ
  3. วางหมายเลขโปรเจ็กต์ Google Cloud ในหมายเลขโปรเจ็กต์ GCP
  4. คลิกตั้งค่าโปรเจ็กต์

ตอนนี้คุณมีโค้ดแอปที่ใช้งานได้ซึ่งสามารถลองใช้ได้ (ตามที่อธิบายไว้ในขั้นตอนต่อไปนี้) จากนั้นจึงปรับแต่งให้ตรงตามข้อกำหนด

ตรวจสอบว่าลงชื่อเข้าใช้บัญชี Google ที่ถูกต้องเมื่อเปิดเทมเพลต Apps Script บางครั้งบัญชีปัจจุบันอาจเปลี่ยนเป็นบัญชีเริ่มต้นโดยที่คุณไม่ทราบ

สร้างการทดสอบการทำให้ใช้งานได้

คุณต้องมีรหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์ Apps Script นี้เพื่อใช้ในขั้นตอนถัดไป

ในการรับรหัสการทำให้ใช้งานได้ของส่วนหัว ให้ทำดังนี้

  1. ในโปรเจ็กต์ Apps Script ของแอป Chat ให้คลิกทำให้ใช้งานได้ > ทดสอบการทำให้ใช้งานได้
  2. คัดลอกรหัสการทำให้ใช้งานได้ของส่วนหัวเพื่อใช้ในขั้นตอนถัดไป แล้วคลิกเสร็จสิ้น

เผยแพร่แอป Chat

เผยแพร่แอป Chat จากคอนโซล Google Cloud

  1. ใน Google Cloud Console ให้ค้นหา Google Chat API แล้วคลิก Google Chat API
  2. คลิกจัดการ

  3. คลิกการกำหนดค่า แล้วตั้งค่าแอป Chat ดังนี้

    1. ในช่องชื่อแอป ให้ป้อน Quickstart app
    2. ในช่อง URL ของรูปโปรไฟล์ ให้ป้อน https://developers.google.com/chat/images/quickstart-app-avatar.png
    3. ในช่องคำอธิบาย ให้ป้อน Quickstart app
    4. ในส่วนฟังก์ชัน ให้เลือกรับข้อความแบบ 1:1 และเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
    5. ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือกโครงการ Apps Script
    6. วางรหัสการทำให้ใช้งานได้ของส่วนหัวที่คุณคัดลอกไว้ก่อนหน้านี้ในช่องรหัสการทำให้ใช้งานได้
    7. ในส่วน "การเปิดเผย" ให้เลือกบุคคลและกลุ่มเฉพาะในโดเมน แล้วป้อนอีเมลของคุณ

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

แอป Chat พร้อมตอบกลับข้อความแล้ว

ทดสอบแอป Chat

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

  1. เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณให้ไว้เมื่อเพิ่มตัวคุณเองเป็นผู้ทดสอบที่เชื่อถือได้

    ไปที่ Google Chat

  2. คลิก แชทใหม่
  3. ในช่องเพิ่มผู้คนอย่างน้อย 1 คน ให้พิมพ์ชื่อแอป ของคุณ

  4. เลือกแอปใน Chat จากผลการค้นหา ข้อความส่วนตัวจะเปิดขึ้น

  5. ในข้อความส่วนตัวใหม่ที่มีแอป ให้พิมพ์ Hello แล้วกด enter

    ขอขอบคุณที่เพิ่มแอป Chat และสะท้อนข้อความของคุณ

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

แก้ปัญหา

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

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

ล้างข้อมูล

เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อหลีกเลี่ยงการเรียกเก็บเงินกับบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้

  1. ในคอนโซล Google Cloud ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร

    ไปที่เครื่องมือจัดการทรัพยากร

  2. ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิกลบ
  3. ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์แล้วคลิกปิดเครื่องเพื่อลบโปรเจ็กต์

ขั้นตอนถัดไป

  • สร้างการ์ดแบบอินเทอร์แอกทีฟ ข้อความการ์ดรองรับเลย์เอาต์ที่กำหนดไว้ องค์ประกอบ UI แบบอินเทอร์แอกทีฟ เช่น ปุ่ม และริชมีเดีย เช่น รูปภาพ ใช้ข้อความในการ์ดเพื่อนำเสนอข้อมูลโดยละเอียด รวบรวมข้อมูลจากผู้ใช้ และแนะนำผู้ใช้ในขั้นตอนถัดไป
  • รองรับคำสั่งเครื่องหมายทับ - คำสั่งเครื่องหมายทับให้คุณลงทะเบียนและโฆษณาคำสั่งเฉพาะเจาะจงที่ผู้ใช้กำหนดให้กับแอปของคุณได้ด้วยการพิมพ์คำสั่งที่ขึ้นต้นด้วยเครื่องหมายทับ (/) เช่น /help
  • กล่องโต้ตอบการเปิดตัว กล่องโต้ตอบจะเป็นอินเทอร์เฟซแบบการ์ดเป็นหน้าต่าง ซึ่งแอปของคุณสามารถเปิดเพื่อโต้ตอบกับผู้ใช้ได้ การ์ดหลายใบ สามารถเรียงต่อกันตามลำดับ ซึ่งช่วยให้ผู้ใช้ทำขั้นตอนหลายขั้นตอนได้ เช่น การกรอกข้อมูลในแบบฟอร์ม
  • Codelab: พร้อมที่จะสร้างแอป Chat ที่ล้ำหน้ายิ่งขึ้นแล้วหรือยัง ดูความคิดเห็น แอป Chat จาก Codelab สร้างแอปสำหรับ Google Chat ด้วย Gemini