Panduan ini menjelaskan cara menggunakan metode create
pada resource Reaction
pada Google Chat API untuk menambahkan reaksi terhadap pesan—seperti 👍, widget, dan multiguna.
Resource Reaction
mewakili emoji yang dapat digunakan orang untuk bereaksi terhadap pesan, seperti 👍, signIn,
dan resource.
Prasyarat
Python
- Python 3.6 atau yang lebih baru
- Alat pengelolaan paket pip
Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdatenya, 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 reaksi memerlukan Autentikasi pengguna dengan cakupan otorisasi
chat.messages.reactions.create
,chat.messages.reactions
, atauchat.messages
.
Menambahkan reaksi ke pesan
Untuk membuat reaksi terhadap pesan, teruskan kode berikut dalam permintaan Anda:
- Tentukan cakupan otorisasi
chat.messages.reactions.create
,chat.messages.reactions
, atauchat.messages
. - Panggil
metode
create
pada resourceReaction
. - Setel
parent
ke nama resource pesan yang akan diberi reaksi. - Tetapkan
body
(isi permintaan) ke instanceReaction
dengan kolomunicode
sebagai emoji standar yang direpresentasikan oleh string unicode.
Contoh berikut bereaksi terhadap pesan dengan emoji 😀:
Python
- Di direktori kerja, buat file bernama
chat_reaction_create.py
. Sertakan kode berikut di
chat_reaction_create.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.messages.reactions.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a reaction to a message. ''' # 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().messages().reactions().create( # The message to create a reaction to. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. parent = 'spaces/SPACE/messages/MESSAGE', # The reaction to the message. body = { 'emoji': { # A standard emoji represented by a unicode string. 'unicode': '😀' } } ).execute() # Prints details about the created reaction. print(result) if __name__ == '__main__': main()
Dalam kode, ganti kode berikut:
SPACE
:name
ruang tempat pesan diposting, yang dapat Anda peroleh dari metodespaces.list
di Chat API, atau dari URL ruang.MESSAGE
: nama pesan, yang dapat Anda peroleh dari isi respons yang ditampilkan setelah membuat pesan secara asinkron dengan Chat API, atau dengan nama kustom yang ditetapkan ke pesan pada saat pembuatan.
Dalam direktori kerja, build dan jalankan contoh:
python3 chat_reaction_create.py
Chat API menampilkan instance
Reaction
yang menjelaskan reaksi yang dibuat.