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

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

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

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

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

• บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Chat
• โปรเจ็กต์ Google Cloud

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

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

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

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

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

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

เปิดใช้ Chat API

ก่อนใช้ Google API คุณต้องเปิดใช้งานในโปรเจ็กต์ Google Cloud คุณเปิด API ได้อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud โปรเจ็กต์เดียว

• เปิดใช้ Google Chat API ในคอนโซล Google Cloud

  เปิดใช้ API

กำหนดค่าหน้าจอขอความยินยอม OAuth

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

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

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

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

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

5. หากคุณเลือกภายนอกเป็นประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
   1. ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
   2. ป้อนอีเมลของคุณและผู้ใช้ทดสอบรายอื่นๆ ที่ได้รับอนุญาต จากนั้นคลิกบันทึกและต่อไป
6. ตรวจสอบสรุปการลงทะเบียนแอป หากต้องการเปลี่ยนแปลง ให้คลิกแก้ไข หากการลงทะเบียนแอปเรียบร้อยดี ให้คลิกกลับไปที่หน้าแดชบอร์ด

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

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

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

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

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

1. ไปที่โปรเจ็กต์ Cloud ในคอนโซล Google Cloud
2. คลิกการตั้งค่าและยูทิลิตี more_vert > การตั้งค่าโปรเจ็กต์
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. คัดลอกรหัสการทําให้ใช้งานได้ของ Head เพื่อใช้ในขั้นตอนถัดไป แล้วคลิกเสร็จสิ้น

เผยแพร่แอป Chat

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

1. ในคอนโซล Google Cloud ให้ค้นหา 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. ในส่วน "สิทธิ์" ให้เลือกบุคคลและกลุ่มที่ระบุในโดเมน แล้วป้อนอีเมลของคุณ

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

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

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

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

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

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

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

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

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