Bu kılavuzda, Google Chat API'nin Membership
kaynağında list()
yönteminin nasıl kullanılacağı açıklanmaktadır. Bu yöntem, bir alandaki üyeleri alandaki üyeliklerin sayfalandırılmış ve filtrelenebilir bir listesi olarak listelemek için kullanılır.
- Uygulama kimlik doğrulaması ile üyelikleri listeleme 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ı ile üyelikleri listeleme Kimliği doğrulanmış kullanıcının erişebildiği alanlardaki üyelikleri listeler.
- Google Workspace yöneticisi olarak, yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulamasıyla üyelikleri listelediğinizde, Google Workspace kuruluşunuzdaki tüm alanlardaki üyelikler listelenir.
Membership
kaynağı
bir kullanıcının veya Google Chat uygulamasının bir alana davet edilip edilmediğini, alanda bulunup bulunmadığı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.
- Google Chat API'yi etkinleştirin ve yapılandırın. Chat uygulamanız için ad, simge ve açıklama ekleyin.
- Node.js Cloud İstemci Kitaplığı'nı yükleyin.
- Google Chat API isteğinizde kimlik doğrulaması yapmak istediğiniz yönteme 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 yerel dizininize
credentials.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 bilgileri oluşturun ve kimlik bilgilerini yerel dizininize
- Kullanıcı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arama yapan Chat uygulamasının üyesi olduğu bir Google Chat alanı. Chat uygulaması olarak kimlik doğrulamak 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:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Google Chat API'yi etkinleştirin ve yapılandırın. Chat uygulamanız için ad, simge ve açıklama ekleyin.
- Python Cloud İstemci Kitaplığı'nı yükleyin.
- Google Chat API isteğinizde kimlik doğrulaması yapmak istediğiniz yönteme 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 yerel dizininize
credentials.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 bilgileri oluşturun ve kimlik bilgilerini yerel dizininize
- Kullanıcı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arama yapan Chat uygulamasının üyesi olduğu bir Google Chat alanı. Chat uygulaması olarak kimlik doğrulamak 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.
- Google Chat API'yi etkinleştirin ve yapılandırın. Chat uygulamanız için ad, simge ve açıklama ekleyin.
- Java Cloud İstemci Kitaplığı'nı yükleyin.
- Google Chat API isteğinizde kimlik doğrulaması yapmak istediğiniz yönteme 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 yerel dizininize
credentials.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 bilgileri oluşturun ve kimlik bilgilerini yerel dizininize
- Kullanıcı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arama yapan Chat uygulamasının üyesi olduğu bir Google Chat alanı. Chat uygulaması olarak kimlik doğrulamak 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.
- Google Chat API'yi etkinleştirin ve yapılandırın. Chat uygulamanız için ad, simge ve açıklama ekleyin.
- 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ğrulamak 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ı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.
- Kimliği doğrulanmış kullanıcının veya arama yapan Chat uygulamasının üyesi olduğu bir Google Chat alanı. Chat uygulaması olarak kimlik doğrulamak için Chat uygulamasını alana ekleyin.
Kullanıcı kimlik doğrulamasıyla bir alandaki üyeleri listeleme
Kimliği doğrulanmış kullanıcının erişebildiği bir alanda kullanıcıları, Google Grupları'nı ve Chat uygulamasını listelemek için isteğinizde aşağıdakileri iletin:
- Kullanıcı kimlik doğrulaması ile
chat.memberships.readonly
veyachat.memberships
yetkilendirme kapsamını belirtin. ListMemberships()
yöntemini çağırın.- Google Grupları'nı listelemek için sorgu parametresini
showGroups
olarak ayarlayın.true
Aşağıdaki örnekte, kimliği doğrulanmış kullanıcının görebileceği Google Grubu, insan ve uygulama üyeleri listelenmektedir.
Node.js
Python
Java
Apps Komut Dosyası
Bu örneği çalıştırmak için SPACE_NAME
yerine alanın name
alanındaki kimliği girin. Kimliği ListSpaces()
yöntemini çağırarak veya alanın URL'sinden alabilirsiniz.
Google Chat API, belirtilen alandaki Google Grubu, kullanıcı ve uygulama üyelerinin listesini döndürür.
Uygulama kimlik doğrulaması olan 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 sorgu parametresini
showGroups
olarak ayarlayın.true
Aşağıdaki örnekte, Chat uygulamasının görebildiği 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
yerine alanın name
alanındaki kimliği girin. Kimliği ListSpaces()
yöntemini çağırarak veya alanın URL'sinden alabilirsiniz.
Google Chat API, belirtilen alandaki gerçek kişi olan alan üyelerinin (alan yöneticileri hariç) listesini döndürür.
Google Workspace yöneticisi olarak liste üyeleri
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 hem dahili hem de harici kullanıcılar veya Google Grupları ile ilgili üyelikleri döndürür. Bu nedenle, Chat uygulamaları için üyelikler atlanır.
Bu yöntemi Google Workspace yöneticisi olarak çağırmak için aşağıdakileri yapın:
- Kullanıcı kimlik doğrulamasıyla 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 için
filter
öğesinimember.type
içinHUMAN
ile eşit olacak şekilde ayarlayın. - Kullanıcıları ve grupları döndürmek için
filter
değerinimember.type
içinBOT
AND
showGroups
değerine eşit olmayantrue
olarak ayarlayın.
Daha fazla bilgi ve örnek için Google Workspace yöneticisi olarak Google Chat alanlarını yönetme başlıklı makaleyi inceleyin.
Sayfalandırmayı özelleştirme veya listeyi filtreleme
Üyelikleri listelemek için aşağıdaki sorgu parametrelerini ileterek listelenen üyeliklerin sayfalandırmasını özelleştirin veya üyelikleri filtreleyin:
pageSize
: Döndürülecek maksimum üyelik sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 100 boşluk döndürülür. Maksimum değer 1.000'dir. 1.000'den büyük değerler otomatik olarak 1.000 olarak değiştirilir.pageToken
: Önceki list spaces çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın. Sayfalama yapılırken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer iletmek beklenmedik sonuçlara yol açabilir.filter
: Bir sorgu filtresi. Kullanıcı kimlik doğrulaması gerektirir. Desteklenen sorgu ayrıntıları içinListMembershipsRequest
referansına bakın.
İlgili konular
- Kullanıcı veya Chat uygulaması üyeliği hakkında ayrıntılı bilgi edinin.
- Bir kullanıcıyı veya Chat uygulamasını alana davet edin ya da ekleyin.
- Google Chat alanında kullanıcının üyeliğini güncelleme
- Bir kullanıcıyı veya Chat uygulamasını alandan kaldırma