Method: spaces.messagePins.list

Mencantumkan pin pesan dalam ruang. Pengguna dapat menyematkan pesan penting di ruang untuk memudahkan akses. Untuk mengetahui informasi selengkapnya, lihat Menyematkan atau melepaskan sematan percakapan di Google Chat.

Memerlukan autentikasi pengguna dengan salah satu cakupan otorisasi berikut:

  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces

Permintaan HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/messagePins

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Ruang induk yang memiliki kumpulan item yang disematkan Format: spaces/{space}

Parameter kueri

Parameter
pageSize

integer

Opsional. Jumlah maksimum pin pesan yang ditampilkan. Layanan mungkin menampilkan lebih sedikit pesan daripada nilai ini. Nilai maksimumnya adalah 100. Jika Anda menggunakan nilai lebih dari 100, nilai tersebut akan otomatis diubah menjadi 100. Jika tidak ditentukan, paling banyak 100 pin pesan akan ditampilkan. Nilai negatif akan menampilkan error INVALID_ARGUMENT.
pageToken

string

Opsional. Token halaman yang diterima dari panggilan list message pins sebelumnya. Berikan parameter ini untuk mengambil halaman berikutnya.

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 pin pesan listingan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "messagePins": [
    {
      object (MessagePin)
    }
  ],
  "nextPageToken": string
}
Kolom
messagePins[]

object (MessagePin)

Pesan yang disematkan dari ruang tertentu.
nextPageToken

string

Anda dapat mengirim token 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.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.