Panduan ini menjelaskan cara menggunakan metode get
pada resource membership
Google Chat API untuk mendapatkan detail tentang keanggotaan dalam ruang.
Tujuan
Referensi Membership
mewakili apakah pengguna manusia atau aplikasi Google Chat diundang,
bagian dari, atau tidak
ada dalam ruang.
Mengautentikasi dengan autentikasi aplikasi memungkinkan aplikasi Chat mendapatkan keanggotaan dari ruang yang dimilikinya akses di Google Chat (misalnya, ruang tempat Anda menjadi anggota), tetapi tidak termasuk Keanggotaan aplikasi Chat, termasuk keanggotaannya sendiri. Mengautentikasi dengan autentikasi pengguna menampilkan keanggotaan dari ruang yang dapat diakses oleh pengguna terautentikasi.
Prasyarat
Python
- Business atau Enterprise Akun Google Workspace yang memiliki akses ke Google Chat.
- Menyiapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasi layar izin OAuth.
- Aktifkan dan konfigurasikan Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
- Instal Python Library Klien Google API.
- Buat kredensial akses berdasarkan cara Anda ingin melakukan autentikasi di Google Chat API
permintaan:
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat client ID OAuth
kredensial, lalu simpan kredensial sebagai file JSON yang bernama
client_secrets.json
ke direktori lokal Anda. - Untuk melakukan autentikasi sebagai aplikasi Chat,
buat akun layanan
kredensial, lalu simpan kredensial sebagai file JSON yang bernama
credentials.json
.
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat client ID OAuth
kredensial, lalu simpan kredensial sebagai file JSON yang bernama
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin melakukan autentikasi sebagai pengguna atau Aplikasi Chat.
Mendapatkan detail tentang langganan
Untuk mendapatkan detail tentang langganan di Google Chat, teruskan hal berikut di permintaan:
- Dengan
app authentication, tentukan
cakupan otorisasi
chat.bot
. Dengan autentikasi pengguna, tentukan otorisasichat.memberships.readonly
atauchat.memberships
ruang lingkup proyek. Sebagai praktik terbaik, pilih cakupan yang paling ketat yang masih memungkinkan aplikasi Anda berfungsi. - Panggil
Metode
get
di Resourcemembership
. - Teruskan
name
langganan untuk mendapatkan. Dapatkan nama keanggotaan dari resource langganan Google Chat.
Berikut cara mendapatkan langganan dengan autentikasi pengguna:
Python
- Di direktori kerja, 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 bisa Anda dapatkan dari metodespaces.list
di Chat API, atau dari URL ruang.MEMBER
: nama keanggotaan, yang dapat Anda peroleh dari Metodespaces.members.list
di Chat API.
Dalam direktori kerja, build dan jalankan contoh:
python3 chat_membership_get.py
Chat API menampilkan instance
membership
keanggotaan yang ditentukan.
Topik terkait
- Mencantumkan anggota dalam ruang.
- Mengundang atau menambahkan pengguna atau aplikasi Chat ke ruang.
- Memperbarui langganan pengguna di ruang Google Chat.
- Menghapus pengguna atau aplikasi Chat dari ruang.