Method: spaces.findGroupChats

แสดงผลพื้นที่ทั้งหมดที่มี spaceType == GROUP_CHAT ซึ่งการเป็นสมาชิกของบุคคลนั้นมีผู้ใช้ที่เรียกใช้และผู้ใช้ที่ระบุใน FindGroupChatsRequest.memberships ดูตัวอย่างได้ที่ค้นหาแชทกลุ่ม

หากผู้ใช้ที่โทรบล็อกผู้ใช้บางรายหรือถูกผู้ใช้บางรายบล็อก และไม่พบพื้นที่ที่มีชุดผู้ใช้ที่ระบุทั้งหมด เมธอดนี้จะแสดงพื้นที่ที่ไม่มีผู้ใช้ที่ถูกบล็อกหรือบล็อก

ชุดผู้ใช้ที่ระบุต้องมีเฉพาะการเป็นสมาชิกของบุคคล (ไม่ใช่แอป) คำขอที่มีผู้ใช้ที่ไม่ใช่มนุษย์จะไม่แสดงพื้นที่ใดๆ

ต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ที่มีขอบเขตการให้สิทธิ์อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.memberships

คำขอ HTTP

GET https://chat.googleapis.com/v1/spaces:findGroupChats

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
user[]

string

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

จำนวนผู้ใช้สูงสุดที่ระบุได้ในคำขอเดียวคือ 49

รูปแบบ: users/{user} โดย {user} คือ id ของ person จาก People API หรือ id ของ user ใน Directory API เช่น หากต้องการค้นหาแชทกลุ่มทั้งหมดที่มีผู้ใช้ที่โทรและผู้ใช้รายอื่น 2 ราย โดยมีรหัสโปรไฟล์ People API เป็น 123456789 และ 987654321 คุณสามารถใช้ users/123456789 และ users/987654321 ได้ นอกจากนี้ คุณยังใช้อีเมลเป็นชื่อแทนสำหรับ {user} ได้ด้วย เช่น users/example@gmail.com โดยที่ example@gmail.com คืออีเมลของผู้ใช้ Google Chat
pageSize

integer

ไม่บังคับ จำนวนพื้นที่สูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้

หากไม่ระบุ ระบบจะแสดงผลสเปซไม่เกิน 100 รายการ

ค่าสูงสุดคือ 1,000 หากใช้ค่ามากกว่า 1,000 ระบบจะเปลี่ยนเป็น 1,000 โดยอัตโนมัติ

ค่าลบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT
pageToken

string

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

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุควรตรงกับการเรียกที่ให้โทเค็น การส่งค่าที่แตกต่างกันอาจทำให้ได้ผลลัพธ์ที่ไม่คาดคิด
spaceView

enum (SpaceView)

ประเภทมุมมองพื้นที่ที่ขอ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ค่าเริ่มต้นเป็น SPACE_VIEW_RESOURCE_NAME_ONLY คำขอที่ระบุ SPACE_VIEW_EXPANDED ต้องมีขอบเขตที่อนุญาตให้อ่านข้อมูลพื้นที่ทำงาน เช่น https://www.googleapis.com/auth/chat.spaces หรือ https://www.googleapis.com/auth/chat.spaces.readonly

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับที่มีพื้นที่แชทกลุ่มที่มีผู้ใช้ที่โทรและผู้ใช้ที่ขอ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
ช่อง
spaces[]

object (Space)

รายการพื้นที่ทำงานในหน้าที่ขอ (หรือหน้าแรก)
nextPageToken

string

โทเค็นที่คุณส่งเป็น pageToken เพื่อดึงข้อมูลผลลัพธ์หน้าถัดไปได้ หากว่างเปล่า แสดงว่าไม่มีหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์

SpaceView

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

Enum
SPACE_VIEW_UNSPECIFIED ค่าเริ่มต้น / ไม่ได้ตั้งค่า
SPACE_VIEW_RESOURCE_NAME_ONLY แสดงเฉพาะชื่อทรัพยากรของพื้นที่ทำงาน
SPACE_VIEW_EXPANDED กรอกข้อมูลในช่องทรัพยากรพื้นที่ทำงาน หมายเหตุ: ระบบจะไม่ป้อนข้อมูลในฟิลด์ permissionSettings คำขอที่ระบุ SPACE_VIEW_EXPANDED ต้องมีขอบเขตที่อนุญาตให้อ่านข้อมูลพื้นที่ทำงาน เช่น https://www.googleapis.com/auth/chat.spaces หรือ https://www.googleapis.com/auth/chat.spaces.readonly