คู่มือเริ่มต้นฉบับย่อสําหรับแอป Google Chat Script

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

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

  • ตั้งค่าสภาพแวดล้อมของคุณ
  • ตั้งค่าสคริปต์
  • เผยแพร่แอป
  • เรียกใช้สคริปต์

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

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

เปิดโครงการระบบคลาวด์ใน Google Cloud Console

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

  1. ใน Google Cloud Console ให้ไปที่หน้าเลือกโครงการ

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

  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. หากเลือกผู้ใช้เป็นภายนอก ให้เพิ่มผู้ใช้ทดสอบดังนี้
    1. คลิกเพิ่มผู้ใช้ใต้ผู้ใช้ทดสอบ
    2. ป้อนอีเมลและผู้ใช้ทดสอบคนอื่นๆ ที่ได้รับอนุญาต จากนั้นคลิกบันทึกและดําเนินการต่อ
  6. ตรวจสอบสรุปการลงทะเบียนแอปของคุณ หากต้องการเปลี่ยนแปลง ให้คลิกแก้ไข หาก การลงทะเบียนแอปไม่มีปัญหา ให้คลิกกลับไปที่หน้าแดชบอร์ด

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

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

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

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

คัดลอกหมายเลขโครงการระบบคลาวด์

  1. ไปที่โครงการระบบคลาวด์ใน Google Cloud Console
  2. คลิกการตั้งค่าและยูทิลิตี > การตั้งค่าโปรเจ็กต์
  3. คัดลอกหมายเลขโครงการ

ตั้งค่าโครงการระบบคลาวด์ของ Apps Script

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

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

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

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

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

ในการรับรหัสการทําให้ Head ใช้งานได้ ให้ดําเนินการดังนี้

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

เผยแพร่แอป Chat

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

  1. ค้นหา Google Chat API ใน Google Cloud Console แล้วคลิก Google Chat API
  2. คลิก Manage

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

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

  4. คลิกบันทึกและรีเฟรชหน้า

  5. ในหน้าการกําหนดค่า ภายใต้สถานะแอป ให้ตั้งสถานะเป็นสด - พร้อมให้บริการแก่ผู้ใช้

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

แอป Chat พร้อมที่จะตอบข้อความแล้ว

เรียกใช้สคริปต์

  1. เปิด Chat
  2. ส่งข้อความส่วนตัวใหม่ไปยังแอปโดยคลิกเริ่มแชท > ค้นหาแอป
  3. ในหน้า "ค้นหาแอป" ให้ค้นหา "Quickstart App"
  4. คลิกแชทถัดจากแอปการเริ่มต้นอย่างรวดเร็ว
  5. พิมพ์ Hello ในข้อความส่วนตัวที่มีแอป แล้วกด enter

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

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

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