Bu kılavuzda, bir alandaki üyelikle ilgili ayrıntıları almak için Google Chat API'nin Membership
kaynağındaki get()
metodunun nasıl kullanılacağı açıklanmaktadır.
Google Workspace yöneticisiyseniz Google Workspace kuruluşunuzdaki herhangi bir üyelikle ilgili ayrıntıları almak için get()
yöntemini çağırabilirsiniz.
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.
Uygulama kimlik doğrulaması ile kimlik doğrulama, Chat uygulamasının Google Chat'te erişebildiği alanlardan (ör. üyesi olduğu alanlar) üyelik almasına olanak tanır ancak kendi üyelikleri de dahil olmak üzere Chat uygulaması üyeliklerini hariç tutar. Kullanıcı kimlik doğrulaması ile kimlik doğrulama yaptığınızda, kimliği doğrulanmış kullanıcının erişebildiği alanlardaki üyelikleri döndürülür.
Ö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ı 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 kimliğinizi 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.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip 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ı 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 için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip 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 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ı 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ğ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 kimliğinizi 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:
- 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.
- 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 kimlik doğrulama yapmak için Chat uygulamasını alana ekleyin.
Üyelikle ilgili ayrıntıları alma
Google Chat üyeliğiyle ilgili ayrıntıları öğrenmek için isteğinizde aşağıdaki bilgileri iletin:
- Uygulama kimlik doğrulaması ile
chat.bot
yetkilendirme kapsamını belirtin. Kullanıcı kimlik doğrulamasıylachat.memberships.readonly
veyachat.memberships
yetkilendirme kapsamını belirtin. En iyi uygulama olarak, uygulamanızın çalışmaya devam etmesine izin veren en kısıtlayıcı kapsamı seçin. GetMembership()
yöntemini çağırın.- Alınacak üyeliğin
name
değerini iletin. Google Chat üyelik kaynağından üyelik adını alın.
Kullanıcı kimlik doğrulamasıyla üyelik alma
Kullanıcı kimlik doğrulaması ile üyelik almak için:
Node.js
Python
Java
Apps Komut Dosyası
Bu örneği çalıştırmak için aşağıdakileri değiştirin:
SPACE_NAME
: Alanınname
kimliği. Kimliği,ListSpaces()
metodunu çağırarak veya alanın URL'sinden alabilirsiniz.MEMBER_NAME
: Üyeninname
kimliği.ListMemberships()
yöntemini çağırarak kimliği edinebilirsiniz.
Chat API, belirtilen üyeliğin ayrıntılarını veren bir Membership
örneğini döndürür.
Uygulama kimlik doğrulamasıyla üyelik alma
Uygulama kimlik doğrulaması ile üyelik almak için:
Node.js
Python
Java
Apps Komut Dosyası
Bu örneği çalıştırmak için aşağıdaki kodu değiştirin:
SPACE_NAME
: Alanınname
bilgilerinden alınan kimlik. Kimliği,ListSpaces()
metodunu çağırarak veya alanın URL'sinden alabilirsiniz.MEMBER_NAME
: Üyeninname
kimliği.ListMemberships()
yöntemini çağırarak kimliği edinebilirsiniz.
Chat API, belirtilen üyeliğin ayrıntılarını veren bir Membership
örneğini döndürür.
Google Workspace yöneticisi olarak üyeliklerle ilgili ayrıntıları öğrenin
Google Workspace yöneticisiyseniz Google Workspace kuruluşunuzdaki herhangi bir kullanıcının üyeliğiyle ilgili ayrıntıları almak için GetMembership()
yöntemini çağırabilirsiniz.
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
useAdminAccess
iletrue
arasındaki sorgu parametresini belirtin.
Daha fazla bilgi ve örnek için Google Chat alanlarını Google Workspace yöneticisi olarak yönetme başlıklı makaleyi inceleyin.
İlgili konular
- Bir alandaki üyeleri listeleyin.
- Bir kullanıcıyı veya Chat uygulamasını alana davet etme ya da ekleme
- Google Chat alanındaki kullanıcıların üyeliğini güncelleyin.
- Bir kullanıcıyı veya Chat uygulamasını alandan kaldırma