Memperbarui setelan notifikasi ruang pengguna

Panduan ini menjelaskan cara menggunakan metode patch() di resource SpaceNotificationSetting Google Chat API untuk memperbarui setelan notifikasi ruang pengguna.

Resource SpaceNotificationSetting adalah resource singleton yang mewakili detail tentang setelan notifikasi ruang pengguna tertentu.

Prasyarat

Node.js

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.

• Siapkan lingkungan Anda:
  • Buat project Google Cloud.
  • Konfigurasikan layar izin OAuth.
  • Aktifkan dan konfigurasikan Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
  • Instal Library Klien Cloud Node.js.
  • Buat kredensial client ID OAuth untuk aplikasi desktop. Untuk menjalankan contoh dalam panduan ini, simpan kredensial sebagai file JSON bernama client_secrets.json ke direktori lokal Anda.
  Sebagai panduan, selesaikan langkah-langkah untuk menyiapkan lingkungan Anda dalam panduan memulai ini.
• Pilih cakupan otorisasi yang mendukung autentikasi pengguna.

Contoh kode di halaman ini menggunakan antarmuka gRPC API dengan library klien Google Cloud. Atau, Anda dapat menggunakan antarmuka REST API. Untuk informasi selengkapnya tentang antarmuka gRPC dan REST, lihat Ringkasan Google Chat API.

Memperbarui setelan notifikasi ruang pengguna yang menelepon

Untuk memperbarui setelan notifikasi ruang pengguna, sertakan hal berikut dalam permintaan Anda:

• Tentukan cakupan otorisasi chat.users.spacesettings.
• Panggil metode UpdateSpaceNotificationSetting(), yang meneruskan permintaan UpdateSpaceNotificationSetting untuk memuat perubahan pada setelan notifikasi. Permintaan ini mencakup:
  • spaceNotificationSetting dengan properti berikut:
    • Properti name menentukan setelan notifikasi ruang yang akan diperbarui, yang mencakup ID pengguna atau alias dan ID ruang. Memperbarui setelan notifikasi ruang hanya mendukung pembaruan setelan notifikasi pengguna yang menelepon, yang dapat ditentukan dengan menetapkan salah satu dari hal berikut:
      • Alias me. Misalnya, users/me/spaces/SPACE/spaceNotificationSetting.
      • Alamat email Workspace pengguna yang menelepon. Misalnya, users/[e-mail]/spaces/SPACE/spaceNotificationSetting.
      • ID pengguna yang melakukan panggilan. Misalnya, users/USER/spaces/SPACE/spaceNotificationSetting.
    • notificationSetting: menetapkan tingkat notifikasi, seperti ALL, OFF.
    • muteSetting: mengaktifkan atau menonaktifkan bisu, nilainya dapat berupa MUTED atau UNMUTED.
  • updateMask: menetapkan kolom update, yang dapat mencakup notification_setting, mute_setting.

Contoh berikut memperbarui setelan notifikasi ruang pengguna yang menelepon:

Node.js

chat/client-libraries/cloud/update-space-notification-setting-user-cred.js

Lihat di GitHub

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.spacesettings'];

// This sample shows how to update the space notification setting for the calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s), replace the SPACE_NAME with an actual space name.
  const request = {
    spaceNotificationSetting : {
    	name : 'users/me/spaces/SPACE_NAME/spaceNotificationSetting',
    	notificationSetting : 'ALL',
    	muteSetting : 'UNMUTED'
    },
    updateMask : { paths: ['notification_setting','mute_setting']}
  };

  // Make the request
  const response = await chatClient.updateSpaceNotificationSetting(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

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

Google Chat API memperbarui setelan notifikasi ruang yang ditentukan dan menampilkan instance SpaceNotificationSetting.

Topik terkait

• Mendapatkan setelan notifikasi ruang pengguna yang menelepon.