แสดงผลรายการพื้นที่ทำงานในองค์กร Google Workspace ตามการค้นหาของผู้ดูแลระบบ
ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ที่มีสิทธิ์ของผู้ดูแลระบบ ในคำขอ ให้ตั้งค่า useAdminAccess
เป็น true
คำขอ HTTP
GET https://chat.googleapis.com/v1/spaces:search
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
use |
เมื่อใช้ ผู้ใช้ที่โทรต้องเป็นผู้ดูแลระบบ Google Workspace ที่มีสิทธิ์จัดการแชทและการสนทนาในพื้นที่ทำงาน ต้องใช้ขอบเขต OAuth 2.0 ขณะนี้วิธีการนี้รองรับเฉพาะการเข้าถึงระดับผู้ดูแลระบบเท่านั้น จึงยอมรับเฉพาะ |
page |
จำนวนพื้นที่ทำงานสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลเว้นวรรคมากที่สุด 100 รายการ ค่าสูงสุดคือ 1,000 หากคุณใช้ค่ามากกว่า 1,000 ระบบจะเปลี่ยนค่าเป็น 1,000 โดยอัตโนมัติ |
page |
โทเค็นที่ได้รับจากการเรียกใช้ Search Space ก่อนหน้า ระบุพารามิเตอร์นี้เพื่อดึงข้อมูลหน้าถัดไป เมื่อแบ่งหน้าเว็บ พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุควรตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ การส่งต่อค่าที่แตกต่างกันไปยังพารามิเตอร์อื่นๆ อาจทำให้เกิดผลลัพธ์ที่ไม่คาดคิด |
query |
ต้องระบุ คำค้นหา คุณสามารถค้นหาโดยใช้พารามิเตอร์ต่อไปนี้
ต้องใช้
ต้องระบุ ช่องต่างๆ รองรับเฉพาะโอเปอเรเตอร์ ในช่องเดียวกัน ตัวอย่างคำค้นหาที่ถูกต้องมีดังนี้
|
order |
ไม่บังคับ วิธีเรียงลำดับรายการพื้นที่ทำงาน แอตทริบิวต์ที่รองรับสำหรับการจัดเรียงมีดังนี้
ค่าการดำเนินการเรียงลำดับที่ถูกต้องมีดังนี้
ไวยากรณ์ที่รองรับมีดังนี้
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ตอบกลับพร้อมรายการพื้นที่ทำงานที่เกี่ยวข้องกับคำขอ Search Space
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"spaces": [
{
object ( |
ช่อง | |
---|---|
spaces[] |
หน้าของพื้นที่ทำงานที่ขอ |
next |
โทเค็นที่ใช้เพื่อเรียกข้อมูลหน้าถัดไปได้ หากช่องนี้ว่างเปล่า หมายความว่าไม่มีหน้าถัดไป |
total |
จำนวนรวมของพื้นที่ทำงานที่ตรงกับคำค้นหาในทุกหน้า หากผลลัพธ์มีจำนวนมากกว่า 10,000 ช่อง ค่านี้จะเป็นเพียงค่าประมาณ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/chat.admin.spaces
https://www.googleapis.com/auth/chat.admin.spaces.readonly
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์