Bu kılavuzda, bir kullanıcının veya Chat uygulamasının bir alandaki üyeliğiyle ilgili ayrıntılı bilgi edinmek için Google Chat API'nin membership
kaynağındaki get
yönteminin nasıl kullanılacağı açıklanmaktadır.
Membership
kaynağı, bir insan kullanıcının veya Google Chat uygulamasının bir alana davet edildiğini, bir alanın bir parçası olduğunu ya da bir alanda bulunmadığını belirtir.
Uygulama kimlik doğrulaması ile kimlik doğrulama yapıldığında bir Chat uygulaması Google Chat'te erişebildiği alanlardan (örneğin, üyesi olduğu alanlar) üyelikler alabilir, ancak kendininki de dahil olmak üzere Chat uygulaması üyeliklerini hariç tutar. Kullanıcı kimlik doğrulaması ile kimlik doğrulama, kimliği doğrulanan kullanıcının erişebildiği alanlardaki üyelikleri döndürür.
Ön koşullar
Python
- Python 3.6 veya sonraki sürümler
- pip paket yönetimi aracı
Python için en yeni Google istemci kitaplıkları. Bunları yüklemek veya güncellemek için komut satırı arayüzünüzde aşağıdaki komutu çalıştırın:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Google Chat API'nin etkin ve yapılandırılmış olduğu bir Google Cloud projesi. Adımlar için Google Chat uygulaması oluşturma başlıklı makaleye göz atın.
Yetkilendirme, Chat uygulaması için yapılandırıldı. Üyelik almak aşağıdaki kimlik doğrulama yöntemlerinin her ikisini de destekler:
chat.memberships.readonly
veyachat.memberships
yetkilendirme kapsamıyla kullanıcı kimlik doğrulaması.chat.bot
yetkilendirme kapsamıyla uygulama kimlik doğrulaması.
Bir kullanıcının veya Chat uygulamasının üyeliğiyle ilgili ayrıntıları öğrenme
Google Chat üyeliğiyle ilgili ayrıntılı bilgi edinmek için isteğinizde aşağıdakileri iletin:
- Uygulama kimlik doğrulaması ile
chat.bot
yetkilendirme kapsamını belirtin. Kullanıcı kimlik doğrulaması kullanırkenchat.memberships.readonly
veyachat.memberships
yetkilendirme kapsamını belirtin. En iyi uygulama olarak, uygulamanızın çalışmasına izin veren en kısıtlayıcı kapsamı seçin. membership
kaynağındaget
yöntemini çağırın.- Kazanmak için üyeliğin
name
değerini geçin. Google Chat'in üyelik kaynağından üyelik adını alın.
Kullanıcı kimlik doğrulaması ile üye olmak için:
Python
- Çalışma dizininizde
chat_membership_get.py
adında bir dosya oluşturun. chat_membership_get.py
içine şu kodu ekleyin:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then gets details about a specified membership. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().get( # The membership to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. name='spaces/SPACE/members/MEMBER' ).execute() # Prints details about the membership. print(result) if __name__ == '__main__': main()
Kodda aşağıdakileri değiştirin:
SPACE
: Chat API'dekispaces.list
yönteminden veya bir alanın URL'sinden edinebileceğiniz bir alan adıdır.MEMBER
: Chat API'despaces.members.list
yönteminden alabileceğiniz üyelik adıdır.
Çalışma dizininizde örneği derleyip çalıştırın:
python3 chat_membership_get.py
Chat API, belirtilen üyelikle ilgili ayrıntıların yer aldığı bir membership
örneği döndürür.
İlgili konular
- Alandaki üyeleri listeleyin.
- Bir alana kullanıcı veya Chat uygulaması davet etme ya da ekleme.
- Bir kullanıcının Google Chat alanındaki üyeliğini güncelleme.
- Bir kullanıcıyı veya Chat uygulamasını alandan kaldırma.