ภาพรวมของ Google Chat API

หน้านี้แสดงภาพรวมของวิธีใช้ Google Chat API และเอกสารอ้างอิง

Google Chat API มีอินเทอร์เฟซทั้ง gRPC และ REST รวมถึงไลบรารีของไคลเอ็นต์ที่รองรับทั้ง 2 รูปแบบ หากไลบรารีไคลเอ็นต์ที่มีให้ไม่ตรงกับความต้องการของคุณ คุณก็เขียนไลบรารีไคลเอ็นต์ของคุณเองได้โดยใช้อินเทอร์เฟซ gRPC หรือ REST

ไลบรารีของไคลเอ็นต์

วิธีที่แนะนำสำหรับนักพัฒนาซอฟต์แวร์ส่วนใหญ่ในการเรียกใช้ Google Chat API คือการใช้ไลบรารีไคลเอ็นต์ระบบคลาวด์ที่รองรับอย่างเป็นทางการสำหรับภาษาที่ต้องการ เช่น Python, Java หรือ Node.js

หากคุณเขียนโค้ดด้วย Google Apps Script ให้ใช้บริการ Chat ขั้นสูงแทนการติดตั้งไลบรารีไคลเอ็นต์

ชื่อประเภท เมธอด และช่อง

ประเภท วิธีการ และชื่อช่องของ Google Chat API จะแตกต่างกันไปโดยขึ้นอยู่กับว่าคุณใช้ไลบรารีของไคลเอ็นต์, gRPC หรือ REST

  • ไลบรารีไคลเอ็นต์ Cloud จะจัดเรียงตามบริการ gRPC และเมธอดของบริการ ไลบรารีของไคลเอ็นต์ Google API จัดเรียงเป็นบริการที่มีออบเจ็กต์หรือคลาสที่สอดคล้องกับทรัพยากร REST ซึ่งก็มีเมธอดที่เกี่ยวข้องด้วย
  • gRPC จะจัดเรียงตามบริการและเมธอดของบริการ
  • REST จะจัดเรียงตามลําดับชั้นของทรัพยากรและเมธอดของทรัพยากร
  • ชื่อช่อง gRPC ใช้รูปแบบ Snake Case
  • ชื่อช่อง REST ใช้รูปแบบ Camel Case แต่บริการ API จะยอมรับทั้งรูปแบบ Camel Case หรือ Snake Case
  • ชื่อช่องของไลบรารีไคลเอ็นต์จะใช้อักษรตัวแรกเป็นตัวพิมพ์ใหญ่ แบบ Camel Case หรือ Snake Case ขึ้นอยู่กับว่าชื่อใดเป็นรูปแบบที่สื่อความหมายสำหรับภาษานั้นๆ

บัฟเฟอร์โปรโตคอล

ไม่ว่าคุณจะใช้ไลบรารีไคลเอ็นต์, REST หรือ gRPC บริการพื้นฐานจะกำหนดโดยใช้ Protocol Buffers โดยบริการนี้ใช้ proto3

เมื่อเรียก API ฟิลด์คำขอหรือคำตอบบางฟิลด์อาจต้องใช้ความเข้าใจพื้นฐานเกี่ยวกับประเภทที่รู้จักของบัฟเฟอร์โปรโตคอล

นอกจากนี้ เมื่อเรียก REST API ลักษณะการทํางานของค่าเริ่มต้นสําหรับบัฟเฟอร์โปรโตคอลอาจทําให้ช่องหายไปในการตอบกลับ JSON ระบบตั้งค่าฟิลด์เหล่านี้เป็นค่าเริ่มต้น จึงจะไม่รวมอยู่ในคำตอบ

เวอร์ชัน API

API เวอร์ชันต่อไปนี้พร้อมใช้งาน

  • v1: เวอร์ชันเสถียร

ตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์

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