Panduan ini menjelaskan cara menggunakan metode get
pada resource membership
Google Chat API untuk mendapatkan detail tentang keanggotaan pengguna atau
aplikasi Chat dalam ruang.
Resource Membership
mewakili apakah pengguna manusia atau aplikasi Google Chat diundang ke,
sebagian, atau tidak ada dalam ruang.
Mengautentikasi dengan autentikasi aplikasi memungkinkan aplikasi Chat mendapatkan keanggotaan dari ruang yang dapat diaksesnya di Google Chat (misalnya, ruang tempatnya bergabung), tetapi tidak termasuk keanggotaan aplikasi Chat, termasuk keanggotaannya sendiri. Mengautentikasi dengan autentikasi pengguna akan menampilkan keanggotaan dari ruang yang dapat diakses oleh pengguna terautentikasi.
Prasyarat
Python
- Python 3.6 atau yang lebih baru
- Alat pengelolaan paket pip
Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdatenya, jalankan perintah berikut di antarmuka command line Anda:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Project Google Cloud dengan Google Chat API yang diaktifkan dan dikonfigurasi. Untuk mengetahui langkah-langkahnya, lihat Mem-build aplikasi Google Chat.
Otorisasi dikonfigurasi untuk aplikasi Chat. Mendapatkan langganan mendukung kedua metode autentikasi berikut:
- Autentikasi pengguna
dengan cakupan otorisasi
chat.memberships.readonly
atauchat.memberships
. - Autentikasi aplikasi
dengan cakupan otorisasi
chat.bot
.
- Autentikasi pengguna
dengan cakupan otorisasi
Mendapatkan detail tentang keanggotaan pengguna atau aplikasi Chat
Untuk mendapatkan detail tentang langganan di Google Chat, teruskan hal berikut dalam permintaan Anda:
- Dengan autentikasi aplikasi, tentukan cakupan otorisasi
chat.bot
. Dengan autentikasi pengguna, tentukan cakupan otorisasichat.memberships.readonly
atauchat.memberships
. Sebagai praktik terbaik, pilih cakupan yang paling ketat yang masih memungkinkan aplikasi Anda berfungsi. - Panggil
metode
get
di resourcemembership
. - Teruskan
name
langganan untuk mendapatkannya. Dapatkan nama keanggotaan dari resource keanggotaan Google Chat.
Berikut cara mendapatkan langganan dengan autentikasi pengguna:
Python
- Di direktori kerja Anda, buat file bernama
chat_membership_get.py
. Sertakan kode berikut di
chat_membership_get.py
: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()
Dalam kode, ganti kode berikut:
SPACE
: nama ruang, yang dapat Anda peroleh dari metodespaces.list
di Chat API, atau dari URL ruang.MEMBER
: nama keanggotaan, yang dapat Anda peroleh dari metodespaces.members.list
di Chat API.
Di direktori kerja Anda, buat dan jalankan contoh:
python3 chat_membership_get.py
Chat API menampilkan instance
membership
yang menjelaskan keanggotaan yang ditentukan.
Topik terkait
- Membuat daftar anggota dalam ruang.
- Undang atau tambahkan pengguna atau aplikasi Chat ke ruang.
- Memperbarui keanggotaan pengguna di ruang Google Chat.
- Menghapus pengguna atau aplikasi Chat dari ruang.