Panduan ini menjelaskan cara menggunakan metode delete
pada resource Space
Google Chat API untuk menghapus ruang yang telah diberi nama jika tidak diperlukan lagi. Menghapus
ruang juga akan menghapus semua yang ada di dalamnya, termasuk pesan dan
lampiran.
Tujuan
Referensi Space
mewakili tempat pengguna dan aplikasi Chat dapat mengirim pesan,
berbagi file, dan berkolaborasi. Ada beberapa jenis ruang:
- Pesan langsung (DM) adalah percakapan antara dua pengguna atau pengguna dan aplikasi Chat.
- {i>Chat<i} grup adalah percakapan antara tiga pengguna atau lebih dan Aplikasi Chat.
- Ruang bernama adalah tempat tetap tempat orang mengirim pesan, berbagi file, dan berkolaborasi.
Prasyarat
Python
- Python 3.6 atau yang lebih baru
- pip alat pengelolaan paket
Library klien Google terbaru untuk Python. Untuk menginstal atau memperbaruinya, 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 Buat aplikasi Google Chat.
Otorisasi yang dikonfigurasi untuk aplikasi Chat. Menghapus sebuah ruang membutuhkan Autentikasi pengguna dengan cakupan otorisasi
chat.delete
dari pengguna yang memiliki izin untuk menghapus ruang yang ditentukan.
Node.js
- Node.js & NPM
Library klien Google terbaru untuk Node.js. Untuk menginstalnya, jalankan perintah berikut di antarmuka command line Anda:
npm install @google-cloud/local-auth @googleapis/chat
- Project Google Cloud dengan Google Chat API yang diaktifkan dan dikonfigurasi. Untuk mengetahui langkah-langkahnya, lihat Buat aplikasi Google Chat.
Otorisasi yang dikonfigurasi untuk aplikasi Chat. Menghapus sebuah ruang membutuhkan Autentikasi pengguna dengan cakupan otorisasi
chat.delete
dari pengguna yang memiliki izin untuk menghapus ruang yang ditentukan.
Menghapus ruang yang diberi nama
Untuk menghapus ruang yang ada di Google Chat, teruskan dalam permintaan Anda:
- Tentukan cakupan otorisasi
chat.delete
. - Panggil
Metode
delete
pada resourceSpace
. - Teruskan
name
ruang yang akan dihapus.
Berikut cara menghapus ruang:
Python
- Di direktori kerja, buat file bernama
chat_space_delete.py
. Sertakan kode berikut di
chat_space_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.delete"] def main(): ''' Authenticates with Chat API via user credentials, then deletes the specified space. ''' # 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().delete( # The space 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. name='spaces/SPACE' ).execute() # Print Chat API's response in your command line interface. # When deleting a space, the response body is empty. print(result) if __name__ == '__main__': main()
Dalam kode, ganti
SPACE
dengan nama ruang, yang dapat diperoleh dari Metodespaces.list
di Chat API, atau dari URL ruang.Dalam direktori kerja, build dan jalankan contoh:
python3 chat_space_delete.py
Node.js
- Di direktori kerja, buat file bernama
delete-space.js
. Sertakan kode berikut di
delete-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Deletes a Chat space. * @return {!Promise<!Object>} */ async function deleteSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.delete', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.delete({name: 'spaces/SPACE'}); } deleteSpace().then(console.log);
Dalam kode, ganti
SPACE
dengan nama ruang, yang yang dapat diperoleh dari Metodespaces.list
di Chat API, atau dari URL ruang.Dalam direktori kerja Anda, jalankan contoh:
node delete-space.js
Jika berhasil, isi respons akan kosong, yang menunjukkan bahwa ruang itu dihapus.
Topik terkait
- Membuat ruang
- Mendapatkan detail tentang ruang.
- Mencantumkan ruang.
- Memperbarui ruang.
- Menghapus ruang.
- Menyiapkan ruang.
- Menemukan ruang pesan langsung.