Method: spaces.members.list

Bir alandaki üyelikleri listeler. Örnek olarak, Üyelikleri listeleme bölümüne bakın. Uygulama kimlik doğrulaması kullanan üyelikler, Chat uygulamasının erişebildiği alanlardaki üyelikleri listeler, ancak kendi uygulamalarının da dahil olduğu Chat uygulaması üyeliklerini hariç tutar. Üyelikleri Kullanıcı kimlik doğrulaması ile listeleme, kimliği doğrulanmış kullanıcının erişebildiği alanlardaki üyelikleri listeler.

Kimlik doğrulama gerektirir. Hizmet hesabı kimlik doğrulamasını ve kullanıcı kimlik doğrulamasını tam olarak destekler. Kullanıcı kimlik doğrulaması, chat.memberships veya chat.memberships.readonly yetkilendirme kapsamının kullanılmasını gerektirir.

HTTP isteği

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

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

Yol parametreleri

Parametreler
parent

string

Zorunlu. Üyelik listesinin getirileceği alanın kaynak adı.

Biçim: boşluklar/{space}

Sorgu parametreleri

Parametreler
pageSize

integer

Döndürülecek maksimum üyelik sayısı. Hizmet bu değerden daha düşük değer döndürebilir.

Belirtilmemesi halinde en fazla 100 üyelik döndürülür.

Maksimum değer 1.000'dir. 1.000'den büyük bir değer kullanırsanız otomatik olarak 1.000 olarak değiştirilir.

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

string

Önceki üyelik çağrısı çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalara ayırma sırasında, sağlanan diğer tüm parametreler sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Diğer parametrelere farklı değerler iletilmesi, beklenmeyen sonuçlara yol açabilir.
filter

string

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

Üyelikleri, üyenin rolüne (role) ve türüne (member.type) göre filtreleyebilirsiniz.

Role göre filtrelemek için role özelliğini ROLE_MEMBER veya ROLE_MANAGER olarak ayarlayın.

Türe göre filtrelemek için member.type değerini HUMAN veya BOT olarak ayarlayın.

Hem role hem de türe göre filtrelemek için AND operatörünü kullanın. Role veya türe göre filtrelemek için OR operatörünü kullanın.

Örneğin, aşağıdaki sorgular geçerlidir:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

Aşağıdaki sorgular geçersiz:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

Geçersiz sorgular sunucu tarafından INVALID_ARGUMENT hatasıyla reddedilir.
showInvited

boolean

İsteğe bağlı. true, diğer üyelik türlerinin yanı sıra invited üyelerle ilişkili üyelikleri de döndürür. Bir filtre ayarlanırsa filtre ölçütleriyle eşleşmeyen invited üyelikleri döndürülmez.

Şu anda kullanıcı kimlik doğrulaması gereklidir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

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

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

object (Membership)

İstenen (veya ilk) sayfadaki üyelik listesi.
nextPageToken

string

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

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.