คู่มือนี้จะอธิบายวิธีใช้วิธี list()
ในทรัพยากร Space
ของ Google Chat API เพื่อแสดงรายการพื้นที่ทำงาน การระบุรายการพื้นที่ทำงานจะแสดงรายการพื้นที่ทำงานแบบแบ่งหน้าซึ่งกรองได้
แหล่งข้อมูล Space
รายการ
แสดงถึงสถานที่ที่ผู้คนและแอป Chat ส่งข้อความได้
แชร์ไฟล์ และทำงานร่วมกัน พื้นที่ทำงานมีหลายประเภทดังนี้
- ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คนหรือผู้ใช้ 1 ราย แอปใน Chat
- แชทเป็นกลุ่มคือการสนทนาระหว่างผู้ใช้ 3 คนขึ้นไปและ แอปแชท
- พื้นที่ทำงานที่มีชื่อคือที่ที่ผู้คนส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน
การแสดงพื้นที่ทำงานที่มีการตรวจสอบสิทธิ์ของแอปจะแสดงพื้นที่ทำงานที่แอป Chat มีสิทธิ์เข้าถึง การระบุรายการพื้นที่ทำงานด้วยการตรวจสอบสิทธิ์ผู้ใช้จะแสดงพื้นที่ทำงานที่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วมีสิทธิ์เข้าถึง
ข้อกำหนดเบื้องต้น
Node.js
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat ของคุณ
- ติดตั้ง ไลบรารีของไคลเอ็นต์ Cloud สำหรับ Node.js
- สร้างข้อมูลเข้าสู่ระบบตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API ดังนี้
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.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 ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์เป็นผู้ใช้หรือ แอป Chat
Java
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมตั้งชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง ชวา ไลบรารีของไคลเอ็นต์ระบบคลาวด์
- สร้างข้อมูลเข้าสู่ระบบโดยอิงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ใน Google Chat API
คำขอ:
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือแอปใน Chat
Apps Script
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมตั้งชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน และเปิดบริการแชทขั้นสูง
- ในคู่มือนี้คุณต้องใช้ผู้ใช้ หรือแอป หากต้องการตรวจสอบสิทธิ์ว่าเป็นแอป 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
หัวข้อที่เกี่ยวข้อง
- สร้างพื้นที่ทำงาน
- ตั้งค่าพื้นที่ทำงาน
- ดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
- อัปเดตพื้นที่ทำงาน
- ลบพื้นที่ทำงาน
- ค้นหาพื้นที่ทำงานของข้อความส่วนตัว