Method: spaces.messagePins.list

Bir alandaki mesaj sabitlemelerini listeler. Kullanıcılar, kolay erişim için alanlardaki önemli mesajları sabitleyebilir. Daha fazla bilgi için Google Chat'te bir görüşmeyi sabitleme veya sabitlemeyi kaldırma başlıklı makaleyi inceleyin.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • 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

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Sabitlenmiş öğe koleksiyonunun sahibi olan üst alan. Biçim: spaces/{space}

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülen maksimum mesaj sabitleme sayısı. Hizmet, bu değerden daha az ileti döndürebilir. Maksimum değer 100'dür. 100'den büyük bir değer kullanırsanız bu değer otomatik olarak 100 olarak değiştirilir. Belirtilmezse en fazla 100 mesaj sabitleme döndürülür. Negatif değerler INVALID_ARGUMENT hatası döndürür.
pageToken

string

İsteğe bağlı. Önceki liste mesajı sabitleme çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalara ayırma işlemi yapılırken sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Diğer parametrelere farklı değerler iletmek beklenmedik sonuçlara yol açabilir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Listeleme mesajı iğneleri için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "messagePins": [
    {
      object (MessagePin)
    }
  ],
  "nextPageToken": string
}
Alanlar
messagePins[]

object (MessagePin)

Belirtilen alandaki sabitlenmiş mesajlar.
nextPageToken

string

Sonraki sonuç sayfasını almak için pageToken olarak bir jeton gönderebilirsiniz. Boşsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.