Membuat ruang

Panduan ini menjelaskan cara menggunakan metode create pada resource Space Google Chat API untuk membuat ruang yang diberi nama.

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.

Ruang yang dinamai adalah tempat orang-orang mengirim pesan, berbagi file, dan berkolaborasi. Ruang bernama dapat mencakup aplikasi Chat. Ruang bernama mencakup fitur tambahan, yaitu percakapan grup tanpa nama dan pesan langsung tidak dimiliki, seperti pengelola ruang yang dapat menerapkan setelan administratif, deskripsi, dan menambahkan atau menghapus orang dan aplikasi. Setelah membuat ruang yang diberi nama, satu-satunya anggota ruang adalah pengguna yang terautentikasi. Ruang ini tidak menyertakan 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 yang diberi nama dengan beberapa anggota—chat grup tanpa nama antara tiga orang atau lebih, atau percakapan pesan langsung antara dua orang, pengguna dan aplikasi Chat yang memanggil Chat API—menyiapkan ruang sebagai gantinya.

Prasyarat

Python

Node.js

Membuat ruang yang diberi nama

Untuk membuat ruang yang diberi nama, teruskan perintah berikut dalam permintaan Anda:

  • Tentukan cakupan otorisasi chat.spaces.create atau chat.spaces.
  • Panggil Metode create di Resource Space.
  • Setel spaceType ke SPACE.
  • Setel displayName menjadi nama ruang yang terlihat oleh pengguna. Dalam contoh berikut, displayName disetel ke API-made.
  • Atau, setel atribut ruang lainnya, seperti spaceDetails (deskripsi dan kumpulan panduan yang dapat dilihat pengguna untuk ruang).

Berikut cara membuat ruang bernama:

Python

  1. Di direktori kerja, buat file bernama chat_space_create_named.py.

  2. 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()

  3. Dalam direktori kerja, build dan jalankan contoh:

    python3 chat_space_create_named.py

Node.js

  1. Di direktori kerja, buat file bernama create-space.js.

  2. 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);

  3. 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 ruang name adalah spaces/1234567, Anda dapat membuka ruang menggunakan URL: https://mail.google.com/chat/u/0/#chat/space/1234567