Memperbarui ruang (original) (raw)

Panduan ini menjelaskan cara menggunakan metodepatch()pada resource Space Google Chat API untuk memperbarui ruang. Perbarui ruang untuk mengubah atribut tentang ruang, seperti nama tampilan yang terlihat oleh pengguna, deskripsi, dan panduannya.

Jika Anda adalah administrator Google Workspace, Anda dapat memanggil metode patch() untuk memperbarui ruang yang ada di organisasi Google Workspace Anda.

ResourceSpacemerepresentasikan tempat di mana orang dan aplikasi Chat dapat mengirim pesan, berbagi file, dan berkolaborasi. Ada beberapa jenis ruang:

Prasyarat

Node.js

Python

Java

Apps Script

Memperbarui ruang sebagai pengguna

Untuk memperbarui ruang yang ada di Google Chat denganautentikasi pengguna, teruskan hal berikut dalam permintaan Anda:

Anda dapat memperbarui hal-hal seperti nama tampilan, jenis ruang, status histori, dan lainnya. Untuk melihat semua kolom yang dapat Anda perbarui, lihatdokumentasi referensi.

Berikut cara memperbarui kolom displayName ruang yang ada:

Node.js

Python

Java

Apps Script

Untuk menjalankan contoh ini, ganti SPACE_NAME dengan ID dari kolomnameruang. Anda bisa mendapatkan ID dengan memanggil metodeListSpaces()atau dari URL ruang.

Google Chat API menampilkan instanceSpace yang mencerminkan pembaruan.

Memperbarui ruang sebagai administrator Google Workspace

Jika Anda adalah administrator Google Workspace, Anda dapat memanggil metodeUpdateSpace() untuk memperbarui ruang di organisasi Google Workspace Anda.

Untuk memanggil metode ini sebagai administrator Google Workspace, lakukan hal berikut:

Untuk mengetahui informasi dan contoh selengkapnya, lihatMengelola ruang Google Chat sebagai administrator Google Workspace.

Memperbarui ruang sebagai aplikasi Chat

Autentikasi aplikasi memerlukanpersetujuan administrator satu kali.

Untuk memperbarui ruang yang ada di Google Chat denganautentikasi aplikasi, luluskan hal berikut dalam permintaan Anda:

Anda dapat memperbarui hal-hal seperti nama tampilan, jenis ruang, status histori, setelan izin, dan lainnya. Untuk melihat semua kolom yang dapat Anda perbarui, lihatdokumentasi referensi.

Berikut cara memperbarui kolom spaceDetails ruang yang ada:

Python

  1. Di direktori kerja Anda, buat file bernama chat_space_update_app.py.
  2. Sertakan kode berikut di chat_space_update_app.py:
from google.oauth2 import service_account  
from apiclient.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.app.spaces"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then updates the specified space description and guidelines.  
    '''  
    # Specify service account details.  
    creds = (  
        service_account.Credentials.from_service_account_file('credentials.json')  
        .with_scopes(SCOPES)  
    )  
    # Build a service endpoint for Chat API.  
    chat = build('chat', 'v1', credentials=creds)  
    # Use the service endpoint to call Chat API.  
    result = chat.spaces().patch(  
      # The space to update, and the updated space details.  
      #  
      # 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',  
      updateMask='spaceDetails',  
      body={  
        'spaceDetails': {  
          'description': 'This description was updated with Chat API!',  
          'guidelines': 'These guidelines were updated with Chat API!'  
        }  
      }  
    ).execute()  
    # Prints details about the updated space.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. Dalam kode, ganti kode berikut:
    • SPACE dengan nama ruang, yang dapat Anda peroleh dari metode spaces.listdi Chat API, atau dari URL ruang.
  2. Di direktori kerja Anda, buat dan jalankan sampel:
python3 chat_space_update_app.py

Google Chat API menampilkan instanceresource Space yang mencerminkan pembaruan.

Batasan dan pertimbangan