این راهنما نحوه استفاده از روش create
در منبع Reaction
در Google Chat API برای افزودن واکنش به یک پیام توضیح میدهد - مانند 👍، 🚲، و 🌞.
منبع Reaction
نشاندهنده شکلکهایی است که افراد میتوانند از آن برای واکنش به پیامی مانند 👍، 🚲 و 🌞 استفاده کنند.
پیش نیازها
پایتون
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- کتابخانه Google API Client Python را نصب کنید.
- شناسه مشتری OAuth را برای یک برنامه دسکتاپ ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
client_secrets.json
در فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
یک واکنش به پیام اضافه کنید
برای ایجاد واکنش به یک پیام، موارد زیر را در درخواست خود وارد کنید:
- محدوده مجوز
chat.messages.reactions.create
،chat.messages.reactions
یاchat.messages
را مشخص کنید. - متد
create
را در منبعReaction
فراخوانی کنید. -
parent
را روی نام منبع پیام برای واکنش به آن تنظیم کنید. -
body
(بدن درخواست) را روی نمونهای ازReaction
تنظیم کنید که در آن فیلدunicode
یک شکلک استاندارد است که با یک رشته یونیکد نمایش داده میشود.
مثال زیر به پیامی با ایموجی 😀 واکنش نشان می دهد:
پایتون
- در پوشه کاری خود، یک فایل با نام
chat_reaction_create.py
ایجاد کنید. کد زیر را در
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()
در کد زیر را جایگزین کنید:
SPACE
:name
فضایی که پیام در آن پست می شود، که می توانید آن را از روشspaces.list
در Chat API یا از URL یک فضا دریافت کنید.MESSAGE
: نام پیامی است که می توانید آن را از بدنه پاسخی که پس از ایجاد پیام به طور ناهمزمان با Chat API یا با نام سفارشی اختصاص داده شده به پیام در هنگام ایجاد، بازگردانده شده است، دریافت کنید.
در پوشه کاری خود، نمونه را بسازید و اجرا کنید:
python3 chat_reaction_create.py
Chat API نمونهای از Reaction
را برمیگرداند که جزئیات واکنش ایجاد شده را نشان میدهد.