Method: users.sections.items.list

Bir bölümdeki öğeleri listeler.

Bölüm öğeleri yalnızca alan olabilir. Ayrıntılı bilgi için Google Chat'te bölüm oluşturma ve düzenleme başlıklı makaleyi inceleyin.

Yetkilendirme kapsamı ile kullanıcı kimlik doğrulaması gerektirir:

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

HTTP isteği

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

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

Yol parametreleri

Parametreler
parent

string

Zorunlu. Üst öğe, bu bölüm öğeleri koleksiyonunun sahibi olan bölüm kaynak adıdır. Yalnızca arayan kullanıcı için liste bölümü öğelerini destekler.

Alana göre filtreleme yaparken tüm bölümlerde arama yapmak için joker karakteri - kullanın. Örneğin, users/{user}/sections/-.

Biçim: users/{user}/sections/{section}

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum bölüm öğesi sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.

Belirtilmemesi halinde en fazla 10 bölüm öğesi döndürülür.

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.

Negatif değerler INVALID_ARGUMENT hatası döndürür.
pageToken

string

İsteğe bağlı. Önceki bir liste bölümü öğeleri çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalama 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.
filter

string

İsteğe bağlı. Sorgu filtresi.

Şu anda yalnızca alana göre filtreleme desteklenmektedir.

Örneğin, space = spaces/{space}.

Geçersiz sorgular INVALID_ARGUMENT hatasıyla reddedilir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Listeleme bölümü öğeleri için yanıt mesajı.

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

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

object (SectionItem)

Belirtilen bölümdeki bölüm öğeleri.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

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

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

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