- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Deneyin.
Alandaki üyelikleri listeler. Örnek için Bir alandaki kullanıcıları ve Google Chat uygulamalarını listeleme başlıklı makaleyi inceleyin. Uygulama kimlik doğrulaması ile üyelik girişi, Chat uygulamasının erişebildiği alanlardaki üyelikleri listeler ancak kendi üyelikleri de dahil olmak üzere Chat uygulaması üyeliklerini hariç tutar. Kullanıcı kimlik doğrulaması ile üyelikleri listelemek, kimliği doğrulanmış kullanıcının erişebildiği alanlarda üyelikleri listeler.
Aşağıdaki kimlik doğrulama türlerini destekler:
Kullanıcı kimlik doğrulaması İstekte
useAdminAccess
alanını ayarlayarak bu yöntemi yönetici ayrıcalıklarıyla yetkilendirebilir ve kimlik doğrulaması yapabilirsiniz.
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 |
Zorunlu. Üyelik listesinin alınacağı alanın kaynak adı. Biçim: boşluk/{boşluk} |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
İsteğe bağlı. Döndürülecek maksimum üyelik sayısı. Hizmet bu değerden daha az değer döndürebilir. Belirtilmemesi durumunda en fazla 100 üyelik döndürülür. Maksimum değer 1.000'dir. 1.000'den yüksek bir değer kullanırsanız bu değer otomatik olarak 1.000 olarak değiştirilir. Negatif değerler |
pageToken |
İsteğe bağlı. Üyelikleri listelemek için önceki bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın. Sayfalandırma 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 aktarmak beklenmedik sonuçlara yol açabilir. |
filter |
İsteğe bağlı. Sorgu filtresi. Üyelikleri üyenin rolüne ( Role göre filtrelemek için Türe göre filtrelemek için Hem rol hem de türe göre filtrelemek için
Örneğin, aşağıdaki sorgular geçerlidir:
Şu sorgular geçersizdir:
Geçersiz sorgular sunucu tarafından |
showGroups |
İsteğe bağlı. |
showInvited |
İsteğe bağlı. Şu anda kullanıcı kimlik doğrulaması gerektirmektedir. |
useAdminAccess |
Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.
Yönetici erişimi kullanılırken uygulama üyeliklerini bir alanda listelemek desteklenmez. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Alanın üyeliklerini listeleyen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"memberships": [
{
object ( |
Alanlar | |
---|---|
memberships[] |
Sırasız liste. İstenen (veya ilk) sayfadaki üyeliklerin listesi. |
nextPageToken |
Sonuçların bir sonraki sayfasını almak için |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.admin.memberships.readonly
https://www.googleapis.com/auth/chat.import
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ılavuzunu inceleyin.