تفعيل تسجيل الأخطاء في تطبيقات Google Chat
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة كيفية تفعيل تسجيل أخطاء تطبيق Chat، حتى تتمكّن من طلب البحث عن سجلّات الأخطاء وعرضها في مستكشف سجلّات Google Cloud أثناء اختبار تطبيق Chat.
المتطلبات الأساسية
لتفعيل تسجيل أخطاء تطبيق Chat، يجب استيفاء الشروط التالية:
- حساب Google Workspace لديه إذن الوصول إلى Google Chat
- تطبيق Chat: لإنشاء تطبيق Chat، اتّبِع هذا الدليل السريع.
إعداد البيئة
قبل طلب البحث في سجلّات أخطاء تطبيق Chat، يجب تفعيل Cloud Logging API في مشروع Google Cloud الخاص بتطبيق Chat.
في Google Cloud Console، فعِّل Cloud Logging API. انقر على القائمة
menu
> واجهات برمجة التطبيقات والخدمات
> المكتبة.
> ابحث عن واجهة برمجة تطبيقات Cloud Logging
> انقر على واجهة برمجة تطبيقات Cloud Logging
> تفعيل.
تفعيل واجهة برمجة التطبيقات
تفعيل تسجيل الأخطاء
فعِّل تسجيل الأخطاء، وعندما يعرض تطبيق Chat خطأً، سيتم تسجيله في "تسجيل Cloud". بما أنّ Cloud Logging يفرض تكلفة، قد تحتاج إلى إيقاف تسجيل الأخطاء بعد الانتهاء من تحديد المشاكل وحلّها.
في Google Cloud Console، انتقِل إلى صفحة إعدادات Chat API. انقر على القائمة
menu
> المزيد من المنتجات
> Google Workspace
> مكتبة المنتجات
> واجهة برمجة التطبيقات Google Chat
> إدارة
> الإعدادات.
الانتقال إلى Chat API
ضمن "الوظائف"، اختَر تسجيل الأخطاء في Cloud Logging.
انقر على حفظ.
من الآن فصاعدًا، عندما يعرض تطبيق Chat خطأً، سيتم تسجيل الخطأ في Cloud Logging.
إيقاف تسجيل الأخطاء
بما أنّ Cloud Logging يفرض تكلفة، قد تحتاج إلى إيقاف تسجيل الأخطاء.
في Google Cloud Console، انتقِل إلى صفحة إعدادات Chat API. انقر على القائمة
menu
> المزيد من المنتجات
> Google Workspace
> مكتبة المنتجات
> واجهة برمجة التطبيقات Google Chat
> إدارة
> الإعدادات.
الانتقال إلى Chat API
ضمن "الوظائف"، ألغِ اختيار تسجيل الأخطاء في Cloud Logging.
انقر على حفظ.
من الآن فصاعدًا، عندما يعرض تطبيق Chat خطأً، لن يتم تسجيل الخطأ في Cloud Logging. يمكنك مواصلة طلب البحث في سجلّات الأخطاء السابقة باستخدام "مستكشف السجلّات".
بعد تفعيل تسجيل الأخطاء، يمكنك طلب سجلّات الأخطاء لتطبيق Chat.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains how to enable error logging for your Google Chat app, allowing you to view and analyze errors in Google Cloud Logs Explorer.\u003c/p\u003e\n"],["\u003cp\u003eTo enable error logging, you need a Google Workspace account, a Chat app, and the Cloud Logging API enabled in your Google Cloud project.\u003c/p\u003e\n"],["\u003cp\u003eWhen enabled, Chat app errors are logged to Cloud Logging, which may incur costs; you can disable logging after troubleshooting.\u003c/p\u003e\n"],["\u003cp\u003eYou can turn off error logging to avoid incurring costs from Cloud Logging, but you can still query past logs.\u003c/p\u003e\n"]]],["To enable Chat app error logging, first enable the Cloud Logging API in the Google Cloud console. Then, navigate to the Chat API configuration page and under Functionality, select \"Log errors to Cloud Logging,\" and save. Errors are now logged to Cloud Logging. To disable, deselect \"Log errors to Cloud Logging\" and save. Remember to disable it when troubleshooting is complete, as Cloud Logging incurs a cost. Error logs can be viewed in Google Cloud Logs Explorer.\n"],null,["This page describes how to turn on Chat app error logging, so that you can query and view error logs in [Google Cloud Logs Explorer](https://cloud.google.com/logging/docs/view/logs-viewer-interface) while testing your Chat app.\n\nPrerequisites\n\nTo turn on Chat app error logging, you need:\n\n- A Google Workspace account with access to Google Chat.\n- A Chat app. To build a Chat app, follow this [quickstart](/workspace/chat/quickstart/gcf-app).\n\nSet up the environment\n\nBefore querying Chat app error logs, you must enable the Cloud Logging API in the Chat app's Google Cloud project.\n\n1. In the Google Cloud console, turn on the Cloud Logging API. Click **Menu**\n menu\n \\\u003e **APIs \\& Services**\n \\\u003e **Library** .\n \\\u003e search for **Cloud Logging API**\n \\\u003e click **Cloud Logging API**\n \\\u003e **Enable**.\n\n [Enable the API](https://console.cloud.google.com/marketplace/product/google/logging.googleapis.com)\n\nTurn on error logging\n\nTurn on error logging and when a Chat app returns an error, it logs it to Cloud logging. Because Cloud Logging [incurs a cost](https://cloud.google.com/stackdriver/pricing), you might want to [turn off error logging](#turn-off-error-logging) after you finish troubleshooting.\n\n1. In the Google Cloud console, go to the Chat API **configuration** page. Click **Menu**\n menu\n \\\u003e **More products**\n \\\u003e **Google Workspace**\n \\\u003e **Product Library**\n \\\u003e **Google Chat API**\n \\\u003e **Manage**\n \\\u003e **Configuration**.\n\n [Go to Chat API](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat)\n2. Under Functionality, select **Log errors to Cloud Logging**.\n\n3. Click **Save**.\n\nNow, whenever the Chat app returns an error, the error gets logged to Cloud Logging.\n\nTurn off error logging\n\nBecause Cloud Logging [incurs a cost](https://cloud.google.com/stackdriver/pricing), you might want to turn off error logging.\n\n1. In the Google Cloud console, go to the Chat API **configuration** page. Click **Menu**\n menu\n \\\u003e **More products**\n \\\u003e **Google Workspace**\n \\\u003e **Product Library**\n \\\u003e **Google Chat API**\n \\\u003e **Manage**\n \\\u003e **Configuration**.\n\n [Go to Chat API](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat)\n2. Under Functionality, deselect **Log errors to Cloud Logging**.\n\n3. Click **Save**.\n\nNow, whenever the Chat app returns an error, the error doesn't get logged to Cloud Logging. You can continue to query past error logs using Logs Explorer.\n\nRelated topics\n\nAfter turning on error logging, you're ready to [query error logs](/workspace/chat/query-logs) for your Chat app."]]
