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

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

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

เมื่อผู้ใช้ที่โทรเป็นผู้ใช้ Google Workspace ผู้ใช้ที่ขอทั้งหมดต้องเป็นสมาชิกขององค์กร Google Workspace เดียวกันกับผู้ใช้ที่โทร
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

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

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