Panduan ini menjelaskan cara menggunakan metode delete
pada resource membership
Google Chat API untuk menghapus anggota dari ruang yang juga dikenal sebagai penghapusan
keanggotaan. Pengelola ruang tidak dapat dihapus jika mereka adalah satu-satunya pengelola ruang
di luar angkasa. Tetapkan pengguna lain sebagai pengelola ruang sebelum menghapus pengguna ini
keanggotaan.
Tujuan
Referensi Membership
mewakili apakah pengguna manusia atau aplikasi Google Chat diundang,
bagian dari, atau tidak
ada dalam ruang.
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.
-
Membuat kredensial client ID OAuth untuk aplikasi desktop. Untuk menjalankan
sampel dalam
panduan, simpan kredensial sebagai file JSON bernama
client_secrets.json
ke direktori lokal.
- Pilih cakupan otorisasi yang mendukung autentikasi pengguna.
Menghapus anggota dari ruang
Untuk menghapus pengguna, grup Google, atau aplikasi Chat dari alamat:
- Untuk menghapus pengguna atau grup Google, tentukan otorisasi
chat.memberships
ruang lingkup proyek. Untuk menghapus aplikasi Chat, tentukanchat.memberships.app
cakupan otorisasi (aplikasi hanya dapat menghapus cakupan otorisasinya sendiri keanggotaan; bukan dari aplikasi lain). Sebagai praktik terbaik, pilih cakupan terbatas yang tetap memungkinkan aplikasi Anda berfungsi. - Panggil metode
delete
di Resourcemembership
. - Teruskan
name
langganan yang akan dihapus. Jika keanggotaannya adalah hanya pengelola ruang di ruang, tetapkan pengguna lain sebagai pengelola ruang sebelum menghapus keanggotaan ini.
Berikut cara menghapus langganan:
Python
- Di direktori kerja, buat file bernama
chat_membership_delete.py
. Sertakan kode berikut di
chat_membership_delete.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.app"] def main(): ''' Authenticates with Chat API via user credentials, then deletes the 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().delete( # The membership to delete. # # 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. To delete a Chat app's membership, replace MEMBER # with app; an alias for the app calling the API. name='spaces/SPACE/members/MEMBER' ).execute() # Print Chat API's response in your command line interface. # When deleting a membership, the response body is empty. 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. Untuk menghapus keanggotaan aplikasi, gantiMEMBER
denganapp
.
Dalam direktori kerja, build dan jalankan contoh:
python3 chat_membership_delete.py
Jika berhasil, isi respons akan mengembalikan keanggotaan dengan
'state': 'NOT_A_MEMBER'
, menunjukkan bahwa anggota tidak lagi ada di ruang.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Topik terkait
- Mendapatkan detail tentang keanggotaan pengguna atau aplikasi Chat.
- Mencantumkan anggota dalam ruang.
- Memperbarui langganan pengguna di ruang Google Chat.
- Mengundang atau menambahkan pengguna atau aplikasi Chat ke ruang.