Bu kılavuzda, bir alandaki üyeleri, sayfalara ayrılmış ve filtrelenebilir bir alandaki üyelik listesi olarak listelemek için Google Chat API'nin Membership
kaynağında list()
yönteminin nasıl kullanılacağı açıklanmaktadır.
- Uygulama kimlik doğrulamasıyla üyelikleri listelemek, Chat uygulamasının erişebildiği alanlardaki üyelikleri listeler ancak kendi üyeliği de dahil olmak üzere Chat uygulaması üyeliklerini hariç tutar.
- Kullanıcı kimlik doğrulamasıyla giriş yapıldığında, kimliği doğrulanmış kullanıcının erişebildiği alanlardaki üyelikler listelenir.
- Yönetici ayrıcalıklarını kullanarak kullanıcı kimlik doğrulaması yapan bir Google Workspace yöneticisi olarak üyelikleri listelemek, Google Workspace kuruluşunuzdaki tüm alanlarda üyelikleri listeler.
Membership
kaynağı, gerçek kullanıcıların veya Google Chat uygulamalarının bir alana davet edilip edilmediğini, alanda yer alıp almadığını ya da alanda bulunmadığını gösterir.
Ön koşullar
Node.js
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Node.js Cloud İstemci Kitaplığı'nı yükleyin.
- Google Chat API isteğinizde kimliğinizi doğrulama yönteminize göre erişim kimlik bilgileri oluşturun:
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgileri oluşturun ve kimlik bilgilerini
client_secrets.json
adlı bir JSON dosyası olarak yerel dizininize kaydedin. - Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini
credentials.json
adlı bir JSON dosyası olarak kaydedin.
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgileri oluşturun ve kimlik bilgilerini
- Kullanıcı olarak mı yoksa Chat uygulaması olarak mı kimlik doğrulaması yapmak istediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arayan Chat uygulamasının üyesi olduğu bir Google Chat alanı. Chat uygulaması olarak kimlik doğrulama yapmak için Chat uygulamasını alana ekleyin.
Python
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.
- Ortamınızı ayarlayın:
- Bir Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanızın bir adı, simgesi ve açıklamasıyla Google Chat API'yi etkinleştirin ve yapılandırın.
- Python Cloud İstemci Kitaplığı'nı yükleyin.
- Google Chat API isteğinizde kimliğinizi doğrulama yönteminize göre erişim kimlik bilgileri oluşturun:
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
client_secrets.json
adlı bir JSON dosyası olarak kaydedin. - Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini
credentials.json
adlı bir JSON dosyası olarak kaydedin.
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
- Kullanıcı olarak mı yoksa Chat uygulaması olarak mı kimlik doğrulama yapmak istediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arama yapan Chat uygulamasının üye olduğu bir Google Chat alanı. Chat uygulaması olarak kimlik doğrulama yapmak için Chat uygulamasını alana ekleyin.
Java
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanızın bir adı, simgesi ve açıklamasıyla Google Chat API'yi etkinleştirin ve yapılandırın.
- Java Cloud İstemci Kitaplığı'nı yükleyin.
- Google Chat API isteğinizde kimliğinizi doğrulama yönteminize göre erişim kimlik bilgileri oluşturun:
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
client_secrets.json
adlı bir JSON dosyası olarak kaydedin. - Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini
credentials.json
adlı JSON dosyası olarak kaydedin.
- Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgilerini oluşturun ve kimlik bilgilerini yerel dizininize
- Kullanıcı olarak mı yoksa Chat uygulaması olarak mı kimlik doğrulama yapmak istediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arayan Chat uygulamasının üyesi olduğu bir Google Chat alanı. Chat uygulaması olarak kimlik doğrulama yapmak için Chat uygulamasını alana ekleyin.
Apps Komut Dosyası
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Bağımsız bir Apps Komut Dosyası projesi oluşturun ve Gelişmiş Chat Hizmeti'ni etkinleştirin.
- Bu kılavuzda kullanıcı veya uygulama kimlik doğrulamasını kullanmanız gerekir. Sohbet uygulaması olarak kimlik doğrulama yapmak için hizmet hesabı kimlik bilgileri oluşturun. Adımlar için Google Chat uygulaması olarak kimlik doğrulama ve yetkilendirme başlıklı makaleyi inceleyin.
- Kullanıcı olarak mı yoksa Chat uygulaması olarak mı kimlik doğrulaması yapmak istediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arayan Chat uygulamasının üyesi olduğu bir Google Chat alanı. Chat uygulaması olarak kimliğinizi doğrulamak için Chat uygulamasını alana ekleyin.
Kullanıcı kimlik doğrulaması ile bir alandaki üyeleri listeleme
Kimliği doğrulanmış kullanıcının erişebildiği bir alandaki kullanıcıları, Google Gruplar'ı ve Chat uygulamasını listelemek için isteğinizde aşağıdakileri iletin:
- Kullanıcı kimlik doğrulamasıyla
chat.memberships.readonly
veyachat.memberships
yetkilendirme kapsamını belirtin. ListMemberships()
yöntemini çağırın.- Google Grupları'nı listelemek için
showGroups
sorgu parametresinitrue
olarak ayarlayın.
Aşağıdaki örnekte, kimliği doğrulanmış kullanıcının görebildiği Google grubu, gerçek kullanıcı ve uygulama üyeleri listelenmektedir.
Node.js
Python
Java
Apps Komut Dosyası
Bu örneği çalıştırmak için SPACE_NAME
değerini alanın name
alanındaki kimlikle değiştirin. Kimliği, ListSpaces()
yöntemini çağırarak veya alanın URL'sinden alabilirsiniz.
Google Chat API, belirtilen alandaki Google Grubu, gerçek kişiler ve uygulama üyelerinin bir listesini döndürür.
Uygulama kimlik doğrulamasıyla bir alandaki üyeleri listeleme
Kimliği doğrulanmış uygulamanın erişebildiği bir alandaki kullanıcıları ve Chat uygulamasını listelemek için isteğinizde aşağıdakileri iletin:
- Uygulama kimlik doğrulaması ile
chat.bot
yetkilendirme kapsamını belirtin. ListMemberships()
yöntemini çağırın.- Google Grupları'nı listelemek için
showGroups
sorgu parametresinitrue
olarak ayarlayın.
Aşağıdaki örnekte, Chat uygulamasında görünür olan gerçek kişi olan alan üyeleri (alan yöneticileri değil) listelenmiştir:
Node.js
Python
Java
Apps Komut Dosyası
Bu örneği çalıştırmak için SPACE_NAME
alanını alanın name
alanındaki kimlikle değiştirin. Kimliği, ListSpaces()
yöntemini çağırarak veya alanın URL'sinden alabilirsiniz.
Google Chat API, belirtilen alandaki insan alan üyelerinin (alan yöneticileri hariç) bir listesini döndürür.
Google Workspace yöneticisi olarak üyeleri listeleme
Google Workspace yöneticisiyseniz Google Workspace kuruluşunuzdaki herhangi bir alanın üyeliklerini listelemek için ListMemberships()
yöntemini çağırabilirsiniz. Chat API yalnızca kuruluşunuzdaki kullanıcılar (hem dahili hem de harici) veya Google Grupları ile ilgili üyelikleri döndürür. Bu nedenle, Chat uygulamalarının üyeliklerini atlar.
Bu yöntemi Google Workspace yöneticisi olarak çağırmak için aşağıdakileri yapın:
- Kullanıcı kimlik doğrulamasını kullanarak yöntemi çağırın ve yöntemin yönetici ayrıcalıkları kullanılarak çağrılmasını destekleyen bir yetkilendirme kapsamı belirtin.
- İsteğinizde aşağıdaki sorgu parametrelerini belirtin:
useAdminAccess
değerinitrue
olarak ayarlayın.- Yalnızca kullanıcıları döndürmek istiyorsanız
member.type
içinfilter
değeriniHUMAN
olarak ayarlayın. - Kullanıcıları ve grupları geri döndürmek için
member.type
içinfilter
değerini,BOT
AND
showGroups
değerine eşit değil:true
olarak ayarlayın.
Daha fazla bilgi ve örnek için Google Chat alanlarını Google Workspace yöneticisi olarak yönetme başlıklı makaleyi inceleyin.
Sayfalamayı özelleştirme veya listeyi filtreleme
Üyelikleri listelemek için aşağıdaki sorgu parametrelerini iletin. Bu parametreler, listelenen üyeliklerin sayfalandırmasını özelleştirmenize veya filtrelemenize olanak tanır:
pageSize
: Döndürülecek maksimum üye sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemişse en fazla 100 boşluk döndürülür. Maksimum değer 1.000'dür. 1.000'den fazla değerler otomatik olarak 1.000 olarak değiştirilir.pageToken
: Önceki bir alan liste çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın. Sayfalandırma yapılırken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer göndermek beklenmedik sonuçlara yol açabilir.filter
: Sorgu filtresi. Kullanıcı kimlik doğrulaması gerektirir. Desteklenen sorgu ayrıntıları içinListMembershipsRequest
referansına bakın.
İlgili konular
- Bir kullanıcının veya Chat uygulamasının üyeliğiyle ilgili ayrıntıları öğrenin.
- Bir alana kullanıcı veya Chat uygulaması davet edin ya da alan ekleyin.
- Bir kullanıcının Google Chat alanındaki üyeliğini güncelleme.
- Bir kullanıcıyı veya Chat uygulamasını alandan kaldırma