Panduan ini menjelaskan cara menggunakan metode create
pada resource Space
dalam Google Chat API untuk membuat ruang bernama.
Resource 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 dengan aplikasi Chat.
- Chat grup adalah percakapan antara tiga pengguna atau lebih dan aplikasi Chat.
- Ruang bernama adalah tempat persisten tempat orang-orang mengirim pesan, berbagi file, dan berkolaborasi.
Ruang bernama adalah tempat orang-orang mengirim pesan, berbagi file, dan
berkolaborasi. Ruang bernama dapat mencakup aplikasi Chat. Ruang bernama
mencakup fitur tambahan yang tidak dimiliki oleh percakapan grup dan pesan langsung
tanpa nama, seperti pengelola ruang yang dapat menerapkan setelan administratif,
deskripsi, serta menambahkan atau menghapus orang dan aplikasi. Setelah membuat ruang yang diberi nama, satu-satunya anggota ruang tersebut adalah pengguna terautentikasi. Ruang tidak
mencakup orang atau aplikasi lain; bahkan aplikasi Chat
yang membuatnya. Untuk menambahkan orang, buat keanggotaan dalam ruang dengan memanggil
metode create
di
resource Member
.
Untuk mempelajari caranya, lihat Membuat langganan.
Untuk membuat ruang bernama dengan beberapa anggota—chat grup tanpa nama antara tiga orang atau lebih, atau percakapan pesan langsung antara dua orang, atau orang dengan aplikasi Chat yang memanggil Chat API—siapkan ruang sebagai gantinya.
Prasyarat
Python
- Python 3.6 atau yang lebih baru
- Alat pengelolaan paket pip
Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdate aplikasi tersebut, 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 Membangun aplikasi Google Chat.
Otorisasi yang dikonfigurasi untuk aplikasi Chat. Pembuatan ruang memerlukan Autentikasi pengguna dengan cakupan otorisasi
chat.spaces.create
atauchat.spaces
.
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 Membangun aplikasi Google Chat.
Otorisasi yang dikonfigurasi untuk aplikasi Chat. Pembuatan ruang memerlukan Autentikasi pengguna dengan cakupan otorisasi
chat.spaces.create
atauchat.spaces
.
Membuat ruang yang diberi nama
Untuk membuat ruang yang diberi nama, teruskan perintah berikut dalam permintaan Anda:
- Tentukan cakupan otorisasi
chat.spaces.create
atauchat.spaces
. - Panggil
metode
create
pada resourceSpace
. - Tetapkan
spaceType
keSPACE
. - Tetapkan
displayName
ke nama ruang yang terlihat oleh pengguna. Pada contoh berikut,displayName
ditetapkan keAPI-made
. - Secara opsional, tetapkan atribut ruang lainnya, seperti
spaceDetails
(deskripsi yang terlihat oleh pengguna dan kumpulan panduan untuk ruang).
Berikut cara membuat ruang bernama:
Python
- Di direktori kerja, buat file bernama
chat_space_create_named.py
. Sertakan kode berikut di
chat_space_create_named.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.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a Chat 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().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
Dalam direktori kerja, build dan jalankan contoh:
python3 chat_space_create_named.py
Node.js
- Di direktori kerja, buat file bernama
create-space.js
. Sertakan kode berikut di
create-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Creates a new chat space. * @return {!Promise<!Object>} */ async function createSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.create( {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}}); } createSpace().then(console.log);
Dalam direktori kerja Anda, jalankan contoh:
node create-space.js
Ruang bernama akan dibuat. Untuk membuka ruang, gunakan ID resource ruang untuk membuat URL ruang. Anda dapat menemukan ID resource dari ruang
name
dalam isi respons Google Chat. Misalnya, jika name
ruang Anda adalah spaces/1234567
, Anda dapat membuka ruang menggunakan URL berikut: https://mail.google.com/chat/u/0/#chat/space/1234567
.
Topik terkait
- Tambahkan orang dan aplikasi ke ruang dengan membuat anggota.
- Posting pesan dalam ruang dengan membuat pesan.
- Mendapatkan detail tentang ruang.
- Mencantumkan ruang.
- Memperbarui ruang.
- Menghapus ruang.
- Menyiapkan ruang.
- Menemukan ruang pesan langsung.
- Membuat ruang dapat ditemukan oleh pengguna tertentu.