Method: users.sections.list

Chat kullanıcısının erişebileceği bölümleri listeler. Bölümler, kullanıcıların görüşmelerini gruplandırmasına ve Chat gezinme panelinde gösterilen alan listesini özelleştirmesine yardımcı olur. 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

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

Yol parametreleri

Parametreler
parent

string

Zorunlu. Bu bölüm koleksiyonunun sahibi olan kullanıcı kaynağı adı olan üst öğe. Yalnızca arayan kullanıcının listeleme bölümlerini destekler. Arayan kullanıcıyı belirtmek için aşağıdakilerden birini ayarlayın:

  • me takma adı. Örneğin, users/me.

  • Workspace e-posta adresleri Örneğin, users/user@example.com.

  • Kullanıcı kimliği Örneğin, users/123456789.

Biçim: users/{user}

Sorgu parametreleri

Parametreler
pageSize

integer

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

Belirtilmemişse en fazla 10 bölüm 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ıdır. Önceki bir list sections ç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.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Listeleme bölümleri için yanıt mesajı.

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

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

object (Section)

Belirtilen kullanıcının bölümleri.

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.