يشرح هذا الدليل كيفية استخدام طريقة delete
على مورد Message
الخاص بـ
Google Chat API لحذف رسالة نصية أو بطاقة.
في Chat API، يتم تمثيل رسالة Chat من خلال
مرجع Message
يمكن لمستخدمي Chat إرسال الرسائل التي تحتوي على نصوص فقط،
يمكن لتطبيقات Chat استخدام العديد من ميزات المراسلة الأخرى، بما في ذلك
تعرض واجهات مستخدم ثابتة أو تفاعلية، تجمع المعلومات من
والمستخدمين، وتسليم الرسائل بشكل خاص. لمعرفة المزيد من المعلومات عن المراسلة
الميزات المتوفرة في Chat API، يمكنك الاطّلاع على
نظرة عامة على رسائل Google Chat
من خلال مصادقة التطبيقات، يمكنك استخدام هذه الطريقة لحذف رسالة تفيد بأن تم إرسال تطبيق Chat. مع مصادقة المستخدم، يمكنك استخدام هذه الطريقة لحذف رسالة أرسلها المستخدم الذي تمت مصادقته. في حال حذف إذا كان المستخدم مديرًا للمساحة، قد تتمكّن أيضًا من حذف رسالة أرسلها أعضاء آخرون في المساحة. لمزيد من المعلومات، يُرجى الاطّلاع على مزيد من المعلومات عن دورك كمدير مساحة.
المتطلبات الأساسية
Python
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
هذا الدليل، فاحفظ بيانات الاعتماد كملف JSON اسمه
client_secrets.json
في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
حذف رسالة تتضمن مصادقة المستخدم
لحذف رسالة تتضمن مصادقة المستخدم، قم بتمرير ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.messages
. - عليك استدعاء
طريقة
delete
في صفحة مرجع واحد (Message
) - اضبط
name
على اسم مورد الرسالة المراد حذفها.
يؤدي المثال التالي إلى حذف رسالة تحتوي على مصادقة المستخدم:
Python
- في دليل العمل، أنشئ ملفًا باسم
chat_message_delete_user.py
أدرِج الرمز التالي في
chat_message_delete_user.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"] def main(): ''' Authenticates with Chat API via user credentials, then deletes 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().delete( # The message to delete. # # 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' ).execute() # Prints response to the Chat API call. # When deleting a message, the response body is empty. print(result) if __name__ == '__main__': main()
في الرمز، استبدل ما يلي:
SPACE
: اسم مساحة يمكنك الحصول عليه من الـ طريقة واحدة (spaces.list
) في Chat API أو من عنوان URL للمساحة.MESSAGE
: اسم رسالة يمكنك الحصول عليه من نص الاستجابة الذي تم عرضه بعد إنشاء رسالة بشكل غير متزامن باستخدام Chat API أو باستخدام اسم مخصّص المخصص للرسالة عند الإنشاء.
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_message_delete_user.py
في حالة نجاح الرد، يكون نص الاستجابة فارغًا، مما يشير إلى أن الرسالة حذف.
حذف رسالة تتضمّن مصادقة التطبيقات
لحذف رسالة مع مصادقة التطبيق، فما عليك سوى اجتياز التالية في طلبك:
- حدِّد نطاق تفويض
chat.bot
. - عليك استدعاء
طريقة
delete
في مرجعMessage
. - اضبط
name
على اسم مورد الرسالة المراد حذفها.
يؤدي المثال التالي إلى حذف رسالة تحتوي على مصادقة التطبيقات:
Python
- في دليل العمل، أنشئ ملفًا باسم
chat_delete_message_app.py
أدرِج الرمز التالي في
chat_delete_message_app.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) # Delete a Chat message. result = chat.spaces().messages().delete( # The message to delete. # # 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' ).execute() # Print Chat API's response in your command line interface. # When deleting a message, the response body is empty. print(result)
في الرمز، استبدل ما يلي:
SPACE
:name
للمساحة حيث التي يمكنك الحصول عليها من طريقةspaces.list
في Chat API أو من عنوان URL للمساحة.MESSAGE
: اسم الرسالة، الذي يمكنك الحصول عليه من نص الاستجابة الذي تم عرضه بعد إنشاء رسالة بشكل غير متزامن باستخدام Chat API أو باستخدام اسم مخصّص المخصص للرسالة عند الإنشاء.
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_delete_message_app.py
في حالة نجاح الرد، يكون نص الاستجابة فارغًا، مما يشير إلى أن الرسالة حذف.