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

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

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

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

Python

  • Python 3.6 أو أعلى
  • أداة إدارة حزم pip
  • أحدث مكتبات عملاء Google. لتثبيت التطبيقات أو تحديثها، قم بتشغيل الأمر التالي في واجهة سطر الأوامر: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

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

للحصول على البيانات الوصفية حول مرفق رسالة في 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 مثيلاً من Attachment يوضح بالتفصيل البيانات الوصفية حول مرفق الرسالة المحدد.