این راهنما نحوه استفاده از روش get
در منبع Media
Google Chat API برای دریافت فراداده در مورد پیوست پیام توضیح می دهد. پاسخ نمونه ای از منبع Attachment
است.
وقتی کاربر پیامی به برنامه شما ارسال میکند، Google Chat یک رویداد تعاملی MESSAGE
ارسال میکند. رویداد تعاملی که توسط برنامه شما دریافت میشود شامل یک بدنه درخواست است، که بار JSON نشاندهنده رویداد تعامل، از جمله هر پیوستی است. بسته به اینکه پیوست محتوای آپلود شده (فایل محلی) یا فایل ذخیره شده در Drive باشد، داده های پیوست متفاوت است. منبع Media
فایلی را نشان میدهد که در چت Google آپلود شده است، مانند تصاویر، ویدیوها و اسناد. منبع Attachment
نمونه ای از رسانه – یک فایل – را نشان می دهد که به یک پیام پیوست شده است. منبع Attachment
شامل فراداده مربوط به پیوست است، مانند محل ذخیره آن.
پیش نیازها
پایتون
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- شناسه مشتری OAuth را برای یک برنامه دسکتاپ ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
client_secrets.json
در فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
یک پیوست پیام دریافت کنید
برای دریافت ناهمزمان فراداده مربوط به پیوست پیام در گپ Google، موارد زیر را در درخواست خود ارسال کنید:
- محدوده مجوز
chat.bot
را مشخص کنید. - متد
get
را در منبعAttachment
تماس بگیرید، -
name
پیوست پیام را ارسال کنید.
در اینجا نحوه دریافت فراداده در مورد پیوست پیام آمده است:
پایتون
- در پوشه کاری خود، یک فایل با نام
chat_get_message_attachment.py
ایجاد کنید. کد زیر را در
chat_get_message_attachment.py
قرار دهید:from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Get a Chat message. result = chat.spaces().messages().attachments().get( # The message to get. # # 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. name='spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT' ).execute() # Print Chat API's response in your command line interface. print(result)
در کد،
spaces/ SPACE /messages/ MESSAGE /attachments/ ATTACHMENT
را با نام پیوست پیام جایگزین کنید.در پوشه کاری خود، نمونه را بسازید و اجرا کنید:
python3 chat_get_message_attachment.py
Chat API نمونهای از Attachment
را برمیگرداند که فراداده مربوط به پیوست پیام مشخص شده را جزئیات میدهد.