Menambahkan reaksi ke pesan

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, atau chat.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, atau chat.messages.
  • Panggil metode create pada resource Reaction.
  • Setel parent ke nama resource pesan yang akan diberi reaksi.
  • Tetapkan body (isi permintaan) ke instance Reaction dengan kolom unicode sebagai emoji standar yang direpresentasikan oleh string unicode.

Contoh berikut bereaksi terhadap pesan dengan emoji 😀:

Python

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

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

  3. Dalam kode, ganti kode berikut:

    • SPACE: name ruang tempat pesan diposting, yang dapat Anda peroleh dari metode spaces.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.

  4. Dalam direktori kerja, build dan jalankan contoh:

    python3 chat_reaction_create.py

Chat API menampilkan instance Reaction yang menjelaskan reaksi yang dibuat.