الحصول على البيانات الوصفية حول مرفق رسالة

يوضّح هذا الدليل كيفية استخدام طريقة get على مورد Media لواجهة برمجة تطبيقات Google Chat للحصول على بيانات وصفية حول مرفق رسالة. الاستجابة هي نسخة افتراضية من مورد Attachment.

عندما يُرسِل المستخدم رسالة إلى تطبيقك، يُرسِل Google Chat حدث تفاعل MESSAGE. يتضمّن حدث التفاعل الذي يتلقّاه تطبيقك نص الطلب، وهو حمولة JSON التي تمثِّل حدث التفاعل، بما في ذلك أي مرفقات. وتختلف البيانات الواردة في المرفق بناءً على ما إذا كان المرفق قد تم تحميله محتوى (ملف محلي) أو ملفًا مخزّنًا على Drive. يمثل مورد Media ملفًا تم تحميله إلى Google Chat، مثل الصور والفيديوهات والمستندات. يمثّل مورد Attachment مثيلاً من الوسائط، أي ملف، مرفق برسالة. يتضمن مورد Attachment البيانات الوصفية حول المرفق، مثل مكان حفظه.

المتطلبات الأساسية

Python

  • Python 3.6 أو أحدث
  • إنّ أداة إدارة الحِزم pip

  • أحدث مكتبات عملاء Google للغة Python. لتثبيتها أو تحديثها، شغّل الأمر التالي في واجهة سطر الأوامر:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib google-auth
  • مشروع على Google Cloud تم فيه تفعيل Google Chat API وضبطه لمعرفة الخطوات، يُرجى الاطّلاع على مقالة إنشاء تطبيق Google Chat.

  • تم ضبط التفويض لتطبيق Chat. وتتطلب الرسالة مصادقة التطبيق مع نطاق التفويض chat.bot.

الحصول على مرفق رسالة

للحصول على بيانات وصفية بشكل غير متزامن حول مرفق رسالة في Google Chat، يُرجى تضمين ما يلي في طلبك:

إليك كيفية الحصول على بيانات وصفية حول مرفق رسالة:

Python

  1. في دليل العمل، أنشِئ ملفًا باسم chat_get_message_attachment.py.

  2. ضمِّن الرمز التالي في 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)

  3. في الرمز، استبدل spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT باسم مرفق الرسالة.

  4. في دليل العمل، أنشئ النموذج وقم بتشغيله:

    python3 chat_get_message_attachment.py

تعرض Chat API مثيل Attachment الذي يوضِّح البيانات الوصفية لمرفق الرسالة المحدَّد.