یک واکنش به پیام اضافه کنید

این راهنما نحوه استفاده از روش create را در منبع Reaction در Google Chat API برای افزودن واکنش به یک پیام توضیح می‌دهد - مانند 👍، 🚲، و 🌞.

منبع Reaction نشان‌دهنده شکلک‌هایی است که افراد می‌توانند از آن برای واکنش به پیامی مانند 👍، 🚲 و 🌞 استفاده کنند.

پیش نیازها

پایتون

  • پایتون 3.6 یا بالاتر
  • ابزار مدیریت بسته پیپ

  • جدیدترین کتابخانه های مشتری گوگل برای پایتون. برای نصب یا به روز رسانی آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • یک پروژه Google Cloud با Google Chat API فعال و پیکربندی شده است. برای مراحل، به ساخت برنامه گپ Google مراجعه کنید.

  • مجوز برای برنامه چت پیکربندی شد. برای ایجاد واکنش نیاز به احراز هویت کاربر با محدوده مجوز chat.messages.reactions.create ، chat.messages.reactions یا chat.messages است.

یک واکنش به پیام اضافه کنید

برای ایجاد واکنش به یک پیام، موارد زیر را در درخواست خود وارد کنید:

  • محدوده مجوز chat.messages.reactions.create ، chat.messages.reactions یا chat.messages را مشخص کنید.
  • متد create را در منبع Reaction فراخوانی کنید.
  • parent روی نام منبع پیام برای واکنش به آن تنظیم کنید.
  • body (بدن درخواست) را روی نمونه‌ای از Reaction تنظیم کنید که در آن فیلد unicode یک شکلک استاندارد است که با یک رشته یونیکد نمایش داده می‌شود.

مثال زیر به پیامی با ایموجی 😀 واکنش نشان می دهد:

پایتون

  1. در پوشه کاری خود، یک فایل با نام chat_reaction_create.py ایجاد کنید.

  2. کد زیر را در 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. در کد زیر را جایگزین کنید:

    • SPACE : name فضایی که پیام در آن پست می شود، که می توانید آن را از روش spaces.list در Chat API یا از URL یک فضا دریافت کنید.

    • MESSAGE : نام پیامی است که می توانید آن را از بدنه پاسخی که پس از ایجاد پیام به طور ناهمزمان با Chat API یا با نام سفارشی اختصاص داده شده به پیام در هنگام ایجاد، بازگردانده شده است، دریافت کنید.

  4. در پوشه کاری خود، نمونه را بسازید و اجرا کنید:

    python3 chat_reaction_create.py

Chat API نمونه‌ای از Reaction را برمی‌گرداند که جزئیات واکنش ایجاد شده را نشان می‌دهد.