Method: spaces.findGroupChats

Menampilkan semua ruang dengan spaceType == GROUP_CHAT, yang keanggotaan penggunanya berisi persis pengguna yang memanggil, dan pengguna yang ditentukan dalam FindGroupChatsRequest.memberships.

Jika pengguna yang memanggil memblokir, atau diblokir oleh, beberapa pengguna, dan tidak ada ruang dengan seluruh kumpulan pengguna yang ditentukan ditemukan, metode ini akan menampilkan ruang yang tidak menyertakan pengguna yang diblokir atau memblokir.

Kumpulan pengguna yang ditentukan hanya boleh berisi keanggotaan manusia (non-aplikasi). Permintaan yang berisi pengguna non-manusia tidak menampilkan ruang apa pun.

Memerlukan autentikasi pengguna dengan salah satu cakupan otorisasi berikut:

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

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
user[]

string

Nama resource semua pengguna manusia dalam chat grup dengan pengguna yang melakukan panggilan. Aplikasi Chat tidak dapat disertakan dalam permintaan.

Format: users/{user}, dengan {user} adalah id untuk orang dari People API, atau id untuk pengguna di Directory API. Misalnya, untuk menemukan semua chat grup dengan pengguna yang memanggil dan dua pengguna lainnya, dengan ID profil People API 123456789 dan 987654321, Anda dapat menggunakan users/123456789 dan users/987654321. Anda juga dapat menggunakan email sebagai alias untuk {user}. Misalnya, users/example@gmail.com dengan example@gmail.com adalah email pengguna Google Chat.

Jika pengguna yang memanggil adalah pengguna Google Workspace, semua pengguna yang diminta harus menjadi anggota organisasi Google Workspace yang sama dengan pengguna yang memanggil.
pageSize

integer

Opsional. Jumlah maksimum ruang yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.

Jika tidak ditentukan, paling banyak 100 ruang akan ditampilkan.

Nilai maksimumnya adalah 1.000. Jika Anda menggunakan nilai lebih dari 1.000, nilai tersebut akan otomatis diubah menjadi 1.000.

Nilai negatif akan menampilkan error INVALID_ARGUMENT.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan sebelumnya untuk menemukan chat grup. Berikan parameter ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan harus sesuai dengan panggilan yang memberikan token. Meneruskan nilai yang berbeda dapat menyebabkan hasil yang tidak terduga.
spaceView

enum (SpaceView)

Jenis tampilan ruang yang diminta. Jika tidak disetel, setelan defaultnya adalah SPACE_VIEW_RESOURCE_NAME_ONLY. Permintaan yang menentukan SPACE_VIEW_EXPANDED harus menyertakan cakupan yang memungkinkan pembacaan data ruang, misalnya, https://www.googleapis.com/auth/chat.spaces atau https://www.googleapis.com/auth/chat.spaces.readonly.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons yang berisi ruang chat grup dengan pengguna yang memanggil dan pengguna yang diminta.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
Kolom
spaces[]

object (Space)

Daftar ruang di halaman yang diminta (atau halaman pertama).
nextPageToken

string

Token yang dapat Anda kirim sebagai pageToken untuk mengambil halaman hasil berikutnya. Jika kosong, tidak ada halaman berikutnya.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

SpaceView

Tampilan yang menentukan kolom mana yang harus diisi pada resource Ruang. Untuk memastikan kompatibilitas dengan rilis mendatang, sebaiknya kode Anda mempertimbangkan nilai tambahan.

Enum
SPACE_VIEW_UNSPECIFIED Nilai default / tidak ditetapkan.
SPACE_VIEW_RESOURCE_NAME_ONLY Mengisi hanya nama resource Ruang.
SPACE_VIEW_EXPANDED Mengisi kolom resource Space. Catatan: kolom permissionSettings tidak akan diisi. Permintaan yang menentukan SPACE_VIEW_EXPANDED harus menyertakan cakupan yang memungkinkan pembacaan data ruang, misalnya, https://www.googleapis.com/auth/chat.spaces atau https://www.googleapis.com/auth/chat.spaces.readonly.