Method: users.sections.list

Mencantumkan bagian yang tersedia untuk pengguna Chat. Bagian membantu pengguna mengelompokkan percakapan dan menyesuaikan daftar ruang yang ditampilkan di panel navigasi Chat. Untuk mengetahui detailnya, lihat Membuat & mengelola bagian di Google Chat.

Memerlukan autentikasi pengguna dengan cakupan otorisasi:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

Permintaan HTTP

GET https://chat.googleapis.com/v1/{parent=users/*}/sections

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Induk, yaitu nama resource pengguna yang memiliki kumpulan bagian ini. Hanya mendukung mencantumkan bagian untuk pengguna yang memanggil. Untuk merujuk ke pengguna yang memanggil, tetapkan salah satu hal berikut:

  • Alias me. Misalnya, users/me.

  • Alamat email Workspace mereka. Misalnya, users/user@example.com.

  • ID penggunanya. Misalnya, users/123456789.

Format: users/{user}

Parameter kueri

Parameter
pageSize

integer

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

Jika tidak ditentukan, paling banyak 10 bagian akan ditampilkan.

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

Nilai negatif akan menampilkan error INVALID_ARGUMENT.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan daftar bagian sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

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

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk bagian listingan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "sections": [
    {
      object (Section)
    }
  ],
  "nextPageToken": string
}
Kolom
sections[]

object (Section)

Bagian dari pengguna yang ditentukan.
nextPageToken

string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.