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

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

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

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

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

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

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

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

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

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

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

เปิด Chat API

ก่อนที่จะใช้ Google API คุณต้องเปิด 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 Script

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

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

คัดลอกหมายเลขโปรเจ็กต์ Cloud

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

ตั้งโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ 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 Chat API ใน Google Cloud Console แล้วคลิก Google Chat API
  2. คลิกจัดการ

  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 Script และวางรหัสการทําให้ใช้งานได้ลงในช่อง
    6. ในส่วนสิทธิ์ ให้เลือกผู้คนและกลุ่มที่ต้องการในโดเมน แล้วป้อนอีเมลของคุณ

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

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

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

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

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

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

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

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

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