แก้ปัญหาและแก้ไขข้อผิดพลาดของแอป Google Chat

ส่วนนี้จะอธิบายปัญหาที่พบบ่อยซึ่งคุณอาจพบขณะสร้างและทดสอบแอปใน Chat

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

หากต้องการความช่วยเหลือในการแก้ปัญหาข้อผิดพลาดของการ์ด โปรดดู แก้ปัญหาและแก้ไขการ์ด

แอปไม่ตอบสนอง

หากคุณส่งข้อความถึงแอปใน Chat แล้วแอปตอบกลับว่า "แอปไม่ตอบสนอง" ให้ตรวจสอบการกำหนดค่าของแอปใน Chat ดังนี้

  1. ในคอนโซล Google API ให้คลิกเมนู > API และบริการ > API และบริการที่เปิดใช้ > Google Chat API > การกำหนดค่า

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

  2. ในส่วนสถานะแอป ให้ตรวจสอบว่าคุณเลือกใช้งานจริง - พร้อมให้บริการแก่ผู้ใช้

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

    1. โดยค่าเริ่มต้น แอปจะตอบกลับข้อความส่วนตัวจากผู้ใช้ได้
    2. หากแอปตอบกลับข้อความในพื้นที่ทำงานและแชทเป็นกลุ่ม ให้เลือกเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
    3. ในส่วนการตั้งค่าการเชื่อมต่อ ให้ตรวจสอบว่า URL ปลายทาง HTTP , รหัสการทำให้ใช้งานได้ ของโปรเจ็กต์ Apps Script, ชื่อหัวข้อ ของ Cloud Pub/Sub หรือ Agent Dialogflow ได้รับการตั้งค่าอย่างถูกต้องและมีการทำให้ใช้งานได้
    4. ในส่วนการมองเห็น ให้ตรวจสอบว่าผู้ใช้ที่เหมาะสมมีสิทธิ์เข้าถึงแอปด้วยอีเมลหรือกลุ่มในโดเมน Google Workspace หากใช้งานจริงด้วย Google Workspace Marketplace SDK การตั้งค่าการมองเห็นก็ไม่จำเป็น เนื่องจาก Google Workspace Marketplace จะมีความสำคัญเหนือกว่า

  4. หากเผยแพร่แอปด้วย Google Workspace Marketplace SDK ให้ตรวจสอบการตั้งค่า Google Workspace Marketplace

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

  6. ลองส่งข้อความถึงแอปอีกครั้ง

Google Chat API พร้อมให้บริการสำหรับผู้ใช้ Google Workspace เท่านั้น

เมื่อกำหนดค่าแอปใน Chat คุณอาจได้รับข้อผิดพลาด Google Chat API is only available to Google Workspace users ข้อความนี้หมายความว่าบัญชี Google ที่คุณใช้กำหนดค่า Chat API ไม่ได้เป็นส่วนหนึ่งขององค์กร Google Workspace หากต้องการสร้างแอปใน Chat หรือใช้ Chat API คุณต้องใช้บัญชี Google Workspace account

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

ระบบอาจนำผู้ใช้ออกจากพื้นที่ทำงาน

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

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

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

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

แก้ปัญหาบริการ Chat ขั้นสูงใน Google Apps Script

ดูหน้า Apps Script เกี่ยวกับ บริการ Chat ขั้นสูง.

ผู้ใช้เพิ่มแอปใน Chat ลงในพื้นที่ทำงานไม่ได้

หากผู้ใช้เห็นข้อความแสดงข้อผิดพลาด This organization's administrator must allow users to install this Chat app เมื่อพยายามเพิ่มแอปใน Chat ลงในพื้นที่ทำงาน ข้อผิดพลาดนี้ อาจเกิดจากสาเหตุใดสาเหตุหนึ่งต่อไปนี้

  • องค์กรได้ปิดใช้แอปใน Chat
  • องค์กรไม่ได้เพิ่มแอปใน Chat ที่เฉพาะเจาะจงนี้ลงในรายการที่อนุญาตขององค์กร

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

ดูข้อมูลเกี่ยวกับวิธีแก้ปัญหานี้ได้ที่หัวข้อ อนุญาตให้ผู้ใช้ติดตั้งแอปใน Chat

ผู้ดูแลระบบต้องให้ขอบเขตการให้สิทธิ์ OAuth ที่จำเป็นแก่แอปสำหรับการดำเนินการนี้

เมื่อ ตรวจสอบสิทธิ์ในฐานะแอปใน Chat, คุณอาจได้รับข้อผิดพลาดต่อไปนี้:

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

ข้อความแสดงข้อผิดพลาดนี้หมายความว่าผู้ดูแลระบบ Google Workspace ยังไม่ได้ให้การอนุมัติแบบครั้งเดียวแก่แอปใน Chat เพื่อใช้ขอบเขตการให้สิทธิ์ที่ขึ้นต้นด้วยชื่อ https://www.googleapis.com/auth/chat.app.*

วิธีแก้ข้อผิดพลาด

  • ขอให้ผู้ดูแลระบบ Google Workspace ให้ การอนุมัติแก่แอปใน Chat เมื่อจัดการข้อผิดพลาดนี้ในตรรกะของแอปใน Chat ให้พิจารณาส่งข้อความประกาศว่า แอปใน Chat ต้องได้รับการอนุมัติจากผู้ดูแลระบบเพื่อดำเนินการ ที่ขอ เช่น To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • หากเมธอด Chat API รองรับขอบเขตการให้สิทธิ์ https://www.googleapis.com/auth/chat.bot ซึ่งไม่จำเป็นต้องได้รับการอนุมัติจากผู้ดูแลระบบ ให้พิจารณาใช้ขอบเขตการให้สิทธิ์นี้แทน หากต้องการตรวจสอบว่าเมธอดใดรองรับขอบเขตการให้สิทธิ์ใด โปรดดูหัวข้อ ตรวจสอบสิทธิ์และให้สิทธิ์แอปใน Google Chat และคำขอ Google Chat API

แก้ปัญหาข้อผิดพลาดของ Cloud Functions

หากแอปใน Chat ได้รับการติดตั้งใช้งานด้วย Cloud Functions และทำงานไม่ถูกต้อง ส่วนต่อไปนี้จะช่วยแก้ปัญหาและแก้ไขข้อผิดพลาด

ตรวจสอบบันทึกของ Cloud Functions

ขั้นตอนแรกคือตรวจสอบบันทึกของ Cloud Functions เพื่อหาข้อผิดพลาด

  1. ในคอนโซล Google API ให้ไปที่หน้า Cloud Functions

    ไปที่ Cloud Functions

  2. หากต้องการเปิดบันทึก ให้ค้นหา Cloud Function ของแอปใน Chat แล้วคลิก แสดงการดำเนินการ > ดูบันทึก

Logs Explorer จะเปิดขึ้นและเรียกใช้การค้นหาที่แสดงบันทึกของ Cloud Functions รวมถึงข้อผิดพลาด

หากข้อมูลเริ่มต้นที่บันทึกไว้ไม่เพียงพอต่อการแก้ไขข้อบกพร่องของแอป คุณสามารถเพิ่มการบันทึกเพิ่มเติมจากโค้ด Cloud Function ได้ ดูหัวข้อดูและเขียนบันทึกของ Cloud Functions

ตรวจสอบข้อผิดพลาดของ Cloud Functions

นอกเหนือจากบันทึกแล้ว Cloud Function ยังอาจรายงานข้อผิดพลาดที่พบขณะทำงานด้วย

  1. ในคอนโซล Google API ให้ไปที่หน้า Cloud Functions

    ไปที่ Cloud Functions

  2. คลิก Cloud Function ของแอปใน Chat

  3. ในหน้ารายละเอียดฟังก์ชัน ข้อผิดพลาดจะแสดงอยู่ในส่วนข้อผิดพลาด

  4. หากต้องการแก้ปัญหาข้อผิดพลาดเพิ่มเติม ให้คลิกข้อผิดพลาดนั้น

แก้ไขข้อผิดพลาดที่พบบ่อยของ Cloud Functions

บางครั้งคุณอาจพบข้อผิดพลาดต่อไปนี้เมื่อสร้างแอปใน Chat ด้วย Cloud Functions

ฟังก์ชัน ChatApp ในภูมิภาค REGION_NAME ในโปรเจ็กต์ PROJECT_NAME มีอยู่แล้ว

เมื่อใช้งานจริง Cloud Function คุณอาจได้รับข้อผิดพลาด Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists ข้อความนี้หมายความว่า Cloud Function อื่นมีชื่อเดียวกับที่คุณกำลังใช้งานจริง เปลี่ยนชื่อแล้วใช้งานจริงฟังก์ชันอีกครั้ง ตรวจสอบว่าแอปใน Chat ใช้ URL ทริกเกอร์สำหรับ Cloud Function ของคุณ ไม่ใช่ URL ทริกเกอร์ของ Cloud Function ที่มีอยู่ก่อน

ผู้ใช้ที่ระบุไว้ในนโยบายอย่างน้อย 1 รายไม่ได้เป็นลูกค้าที่ได้รับอนุญาต

เมื่อใช้งานจริง Cloud Function คุณอาจได้รับข้อผิดพลาด The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." หากคุณได้รับข้อผิดพลาดนี้แล้วส่งข้อความถึง แอปใน Chat คุณจะได้รับข้อผิดพลาดที่ระบุว่าแอปไม่ตอบสนองเนื่องจาก Google Chat เข้าถึงเซิร์ฟเวอร์ที่โฮสต์ Cloud Function ไม่ได้ ข้อความนี้หมายความว่าผู้ใช้ที่ชื่อ "allUsers" ไม่มีสิทธิ์เรียก Cloud Function การมอบบทบาท "ผู้เรียกใช้ Cloud Functions" ให้กับ "allUsers" หมายความว่า Cloud Function ที่ขับเคลื่อนแอปจะพร้อมให้บริการแก่สาธารณะและเข้าถึงได้โดยไม่ต้องตรวจสอบสิทธิ์ ดูวิธีมอบหมายบทบาทได้ที่หัวข้อ ให้บทบาทเดียว

ข้อผิดพลาดนี้อาจหมายความว่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ถูกจำกัดโดเมน ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อจำกัดของข้อจำกัดโดเมนได้ที่หัวข้อ การจำกัดข้อมูลประจำตัวตามโดเมน

หากต้องการแก้ปัญหานี้ ให้ตรวจสอบว่า Cloud Function อนุญาตการเรียกที่ไม่ผ่านการตรวจสอบสิทธิ์ ดูวิธีอนุญาตการเรียกที่ไม่ผ่านการตรวจสอบสิทธิ์สำหรับ Cloud Function ที่มีอยู่ได้ที่ หัวข้อการอนุญาตการเข้าถึงแบบสาธารณะ (ไม่ผ่านการตรวจสอบสิทธิ์)