Panduan ini menjelaskan cara menggunakan metode
get()
pada resource Membership
Google Chat API untuk mendapatkan detail tentang keanggotaan dalam ruang.
Jika Anda adalah administrator Google Workspace, Anda dapat memanggil metode get()
untuk mengambil detail tentang keanggotaan apa pun di organisasi Google Workspace Anda.
Resource
Membership
menunjukkan apakah pengguna manusia atau aplikasi Google Chat diundang ke, menjadi bagian dari, atau tidak ada di ruang.
Mengautentikasi dengan autentikasi aplikasi memungkinkan aplikasi Chat mendapatkan keanggotaan dari ruang yang dapat diaksesnya di Google Chat (misalnya, ruang tempat aplikasi menjadi anggota), tetapi tidak termasuk keanggotaan aplikasi Chat, termasuk keanggotaannya sendiri. Mengautentikasi dengan autentikasi pengguna menampilkan keanggotaan dari ruang yang dapat diakses oleh pengguna yang diautentikasi.
Prasyarat
Node.js
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
- Siapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasi layar izin OAuth.
- Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
- Instal Library Klien Cloud Node.js.
- Buat kredensial akses berdasarkan cara Anda ingin melakukan autentikasi dalam permintaan Google Chat API:
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat kredensial ID klien OAuthdan simpan kredensial sebagai file JSON bernama
credentials.json
ke direktori lokal Anda. - Untuk mengautentikasi sebagai aplikasi Chat,
buat kredensial
akun layanan dan simpan kredensial sebagai file JSON bernama
credentials.json
.
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat kredensial ID klien OAuthdan simpan kredensial sebagai file JSON bernama
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin mengautentikasi sebagai pengguna atau aplikasi Chat.
- Ruang Google Chat tempat pengguna yang diautentikasi atau aplikasi Chat yang memanggil menjadi anggota. Untuk mengautentikasi sebagai aplikasi Chat, tambahkan aplikasi Chat ke ruang.
Python
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
- Siapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasi layar izin OAuth.
- Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
- Instal Python Cloud Client Library.
- Buat kredensial akses berdasarkan cara Anda ingin melakukan autentikasi dalam permintaan Google Chat API:
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat kredensial ID klien OAuthdan simpan kredensial sebagai file JSON bernama
credentials.json
ke direktori lokal Anda. - Untuk mengautentikasi sebagai aplikasi Chat,
buat kredensial
akun layanan dan simpan kredensial sebagai file JSON bernama
credentials.json
.
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat kredensial ID klien OAuthdan simpan kredensial sebagai file JSON bernama
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin mengautentikasi sebagai pengguna atau aplikasi Chat.
- Ruang Google Chat tempat pengguna yang diautentikasi atau aplikasi Chat yang memanggil menjadi anggota. Untuk mengautentikasi sebagai aplikasi Chat, tambahkan aplikasi Chat ke ruang.
Java
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
- Siapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasi layar izin OAuth.
- Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
- Instal Java Cloud Client Library.
- Buat kredensial akses berdasarkan cara Anda ingin melakukan autentikasi dalam permintaan Google Chat API:
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat kredensial ID klien OAuthdan simpan kredensial sebagai file JSON bernama
credentials.json
ke direktori lokal Anda. - Untuk mengautentikasi sebagai aplikasi Chat,
buat kredensial
akun layanan dan simpan kredensial sebagai file JSON bernama
credentials.json
.
- Untuk melakukan autentikasi sebagai pengguna Chat,
buat kredensial ID klien OAuthdan simpan kredensial sebagai file JSON bernama
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin mengautentikasi sebagai pengguna atau aplikasi Chat.
- Ruang Google Chat tempat pengguna yang diautentikasi atau aplikasi Chat yang memanggil menjadi anggota. Untuk mengautentikasi sebagai aplikasi Chat, tambahkan aplikasi Chat ke ruang.
Apps Script
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
- Siapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasi layar izin OAuth.
- Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
- Buat project Apps Script mandiri, lalu aktifkan Advanced Chat Service.
- Dalam panduan ini, Anda harus menggunakan autentikasi pengguna atau aplikasi. Untuk melakukan autentikasi sebagai aplikasi Chat, buat kredensial akun layanan. Untuk mengetahui langkah-langkahnya, lihat Mengautentikasi dan mengizinkan sebagai aplikasi Google Chat.
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin mengautentikasi sebagai pengguna atau aplikasi Chat.
- Ruang Google Chat tempat pengguna yang diautentikasi atau aplikasi Chat yang memanggil menjadi anggota. Untuk mengautentikasi sebagai aplikasi Chat, tambahkan aplikasi Chat ke ruang.
Mendapatkan detail tentang langganan
Untuk mendapatkan detail tentang langganan di Google Chat, teruskan hal berikut dalam permintaan Anda:
- Dengan
autentikasi aplikasi, tentukan
cakupan otorisasi
chat.bot
. Dengan autentikasi pengguna, tentukan cakupan otorisasichat.memberships.readonly
atauchat.memberships
. Sebagai praktik terbaik, pilih cakupan yang paling ketat yang masih memungkinkan aplikasi Anda berfungsi. - Panggil
metode
GetMembership()
. - Teruskan
name
langganan yang akan didapatkan. Dapatkan nama keanggotaan dari resource keanggotaan Google Chat.
Mendapatkan langganan dengan autentikasi pengguna
Berikut cara mendapatkan langganan dengan autentikasi pengguna:
Node.js
Python
Java
Apps Script
Untuk menjalankan contoh ini, ganti berikut ini:
SPACE_NAME
: ID dariname
ruang. Anda bisa mendapatkan ID dengan memanggil metodeListSpaces()
atau dari URL ruang.MEMBER_NAME
: ID dariname
anggota. Anda bisa mendapatkan ID dengan memanggil metodeListMemberships()
.
Chat API menampilkan instance
Membership
yang menjelaskan keanggotaan yang ditentukan.
Mendapatkan langganan dengan autentikasi aplikasi
Berikut cara mendapatkan langganan dengan autentikasi aplikasi:
Node.js
Python
Java
Apps Script
Untuk menjalankan contoh ini, ganti berikut ini:
SPACE_NAME
: ID dariname
ruang. Anda bisa mendapatkan ID dengan memanggil metodeListSpaces()
atau dari URL ruang.MEMBER_NAME
: ID dariname
anggota. Anda bisa mendapatkan ID dengan memanggil metodeListMemberships()
.
Chat API menampilkan instance
Membership
yang menjelaskan keanggotaan yang ditentukan.
Mendapatkan detail tentang langganan sebagai administrator Google Workspace
Jika Anda adalah administrator Google Workspace, Anda dapat memanggil metode
GetMembership()
untuk mengambil detail tentang keanggotaan bagi pengguna mana pun di
organisasi Google Workspace Anda.
Untuk memanggil metode ini sebagai administrator Google Workspace, lakukan hal berikut:
- Panggil metode menggunakan autentikasi pengguna, dan tentukan cakupan otorisasi yang mendukung panggilan metode menggunakan hak istimewa administrator.
- Dalam permintaan Anda, tentukan parameter kueri
useAdminAccess
ketrue
.
Untuk mengetahui informasi dan contoh selengkapnya, lihat Mengelola ruang Google Chat sebagai administrator Google Workspace.
Topik terkait
- Mencantumkan anggota dalam ruang.
- Mengundang atau menambahkan pengguna atau aplikasi Chat ke ruang.
- Perbarui keanggotaan pengguna di ruang Google Chat.
- Menghapus pengguna atau aplikasi Chat dari ruang.