คู่มือนี้อธิบายวิธีใช้เมธอด
list()
ในทรัพยากร Space ของ Google Chat API เพื่อแสดงรายการพื้นที่ทำงาน การแสดงรายการพื้นที่ทำงานจะแสดงรายการพื้นที่ทำงานที่แบ่งหน้าและกรองได้
ทรัพยากร
Spaceแสดงถึงพื้นที่ที่ผู้คนและแอป Chat สามารถส่งข้อความ
แชร์ไฟล์ และทำงานร่วมกันได้ พื้นที่ทำงานมีหลายประเภท ดังนี้
- ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คน หรือระหว่างผู้ใช้กับแอป Chat
- การแชทเป็นกลุ่มคือการสนทนาระหว่างผู้ใช้ 3 คนขึ้นไปกับแอป Chat
- พื้นที่ทำงานที่มีชื่อเป็นพื้นที่ถาวรที่ผู้คนส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน
การแสดงรายการพื้นที่ทำงานด้วย การตรวจสอบสิทธิ์แอป จะแสดงพื้นที่ทำงานที่แอป Chat มีสิทธิ์เข้าถึง การแสดงรายการพื้นที่ทำงานด้วยการตรวจสอบสิทธิ์ผู้ใช้จะแสดงพื้นที่ทำงานที่ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์มีสิทธิ์เข้าถึง
ข้อกำหนดเบื้องต้น
Node.js
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
- ติดตั้งไลบรารีของไคลเอ็นต์สำหรับ Cloud ของ Node.js
- สร้างข้อมูลเข้าสู่ระบบเพื่อการเข้าถึงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API
โดยทำดังนี้:
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.jsonในไดเรกทอรีภายในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat,
สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์ตามที่คุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอป Chat
Python
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
- ติดตั้งไลบรารีของไคลเอ็นต์สำหรับ Cloud ของ Python
- สร้างข้อมูลเข้าสู่ระบบเพื่อการเข้าถึงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API
โดยทำดังนี้:
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.jsonในไดเรกทอรีภายในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat,
สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์ตามที่คุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอป Chat
Java
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
- ติดตั้งไลบรารีของไคลเอ็นต์สำหรับ Cloud ของ Java
- สร้างข้อมูลเข้าสู่ระบบเพื่อการเข้าถึงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API
โดยทำดังนี้:
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.jsonในไดเรกทอรีภายในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat,
สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์ตามที่คุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอป Chat
Apps Script
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน, แล้วเปิดใช้บริการ Chat ขั้นสูง
- ในคู่มือนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ หรือแอป หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้าง ข้อมูลเข้าสู่ระบบของบัญชีบริการ ดูขั้นตอนได้ที่ ตรวจสอบสิทธิ์และให้สิทธิ์ในฐานะแอป Google Chat
- เลือกขอบเขตการให้สิทธิ์ตามที่คุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอป Chat
แสดงรายการพื้นที่ทำงานด้วยการตรวจสอบสิทธิ์ผู้ใช้
หากต้องการแสดงรายการพื้นที่ทำงานใน Google Chat ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- เมื่อใช้
การตรวจสอบสิทธิ์ผู้ใช้,
ให้ระบุขอบเขตการให้สิทธิ์
chat.spaces.readonlyหรือchat.spaces - เรียกใช้
ListSpaces()เมธอด
ตัวอย่างต่อไปนี้แสดงรายการพื้นที่ทำงานที่มีชื่อ (แต่ไม่แสดงแชทเป็นกลุ่มและข้อความส่วนตัวซึ่งถูกกรองออก) ที่ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์มองเห็น
Node.js
Python
Java
Apps Script
Chat API จะแสดงรายการพื้นที่ทำงานที่แบ่งหน้า
แสดงรายการพื้นที่ทำงานด้วยการตรวจสอบสิทธิ์แอป
หากต้องการแสดงรายการพื้นที่ทำงานใน Google Chat ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- เมื่อใช้
การตรวจสอบสิทธิ์แอป,
ให้ระบุขอบเขตการให้สิทธิ์
chat.bot - เรียกใช้
ListSpaces()เมธอด
ตัวอย่างต่อไปนี้แสดงรายการพื้นที่ทำงานที่มีชื่อ (แต่ไม่แสดงแชทเป็นกลุ่มและข้อความส่วนตัว) ที่แอป Chat มองเห็น
Node.js
Python
Java
Apps Script
Chat API จะแสดงรายการพื้นที่ทำงานที่แบ่งหน้า
ปรับแต่งการแบ่งหน้าหรือกรองรายการ
หากต้องการแสดงรายการพื้นที่ทำงานใน Google Chat ให้ส่งพารามิเตอร์การค้นหาที่ไม่บังคับต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรองพื้นที่ทำงานที่แสดง
pageSize: จำนวนพื้นที่ทำงานสูงสุดที่จะแสดง บริการอาจแสดงจำนวนพื้นที่ทำงานน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงพื้นที่ทำงานไม่เกิน 100 รายการ ค่าสูงสุดคือ 1,000 โดยระบบจะเปลี่ยนค่าที่สูงกว่า 1,000 เป็น 1,000 โดยอัตโนมัติpageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้การแสดงรายการพื้นที่ทำงานครั้งก่อน ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป เมื่อแบ่งหน้า ค่าตัวกรองควรตรงกับการเรียกใช้ที่ให้โทเค็นหน้าเว็บ การส่งค่าอื่นอาจทำให้เกิดผลลัพธ์ที่ไม่คาดคิดfilter: ตัวกรองการค้นหา ดูรายละเอียดการค้นหาที่รองรับได้ที่ListSpacesRequestข้อมูลอ้างอิง
หัวข้อที่เกี่ยวข้อง
- สร้างพื้นที่ทำงาน
- ตั้งค่าพื้นที่ทำงาน
- ดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
- อัปเดตพื้นที่ทำงาน
- ลบพื้นที่ทำงาน
- ค้นหาพื้นที่ทำงานสำหรับข้อความส่วนตัว