تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتطلّب كل تطبيق تنشئه على Google Chat مشروعًا خاصًا على Google Cloud مع تفعيل واجهة برمجة التطبيقات Chat API وإعدادها. توضّح لك هذه الصفحة كيفية ضبط إعدادات Chat API.
عند تفعيل واجهة Chat API، يمكنك ضبط التفاصيل الخاصة بتطبيق Chat والتي تظهر للمستخدمين في Chat، بما في ذلك الاسم المعروض والصورة الرمزية والوصف. لا تظهر هذه التفاصيل إلا في Chat. لنشر تطبيق Chat على Marketplace، يجب أيضًا تحديد التفاصيل التي تظهر في بطاقة بيانات Marketplace الخاصة بتطبيق Chat.
لاستدعاء Chat API، عليك إعداد تطبيق Google Chat يتضمّن المعلومات التالية:
الحقل
الوصف
التنسيق
اسم التطبيق
الاسم المعروض لتطبيق Chat
ما يصل إلى 25 حرفًا أبجديًا رقميًا
عنوان URL للأفاتار
الصورة التي تظهر كأفاتار لتطبيق Chat
تمثّل هذه السمة عنوان URL يستخدم HTTPS ويشير إلى صورة مربّعة (بتنسيق PNG أو JPEG).
الحجم الموصى به هو 256 × 256 بكسل أو أكثر.
الوصف
وصف موجز للغرض من تطبيق Chat
ما يصل إلى 40 حرفًا أبجديًا رقميًا
يظهر اسم تطبيق Chat وصورته الرمزية ووصفه للمستخدمين في واجهة مستخدم Chat. بالنسبة إلى بعض طلبات الكتابة في Chat API، يستخدم Chat هذه المعلومات لتحديد مصدر الإجراءات التي يتخذها تطبيق Chat في Chat.
على سبيل المثال، إذا استدعيت طريقة spaces.create()، سيضمّن Chat اسم تطبيق Chat في وصف الجهة التي أنشأت المساحة، كما هو موضّح في الصورة التالية:
الشكل 1 رسالة تحديد المصدر التي يعرضها Chat عند استخدام طريقة spaces.create() لإنشاء مساحة نيابةً عن مستخدم.
للتفاعل مع تطبيقات Chat، يمكن للمستخدمين أيضًا الاطّلاع على هذه المعلومات أو استخدامها بالطرق التالية:
استدعِ تطبيق Chat من خلال الإشارة إلى اسمه باستخدام علامة @.
ابحث عن رسالة مباشرة وابدأها باستخدام تطبيق Chat.
في قائمة التطبيقات، تعرض الرسائل المباشرة اسم تطبيق Chat وصورته الرمزية.
من شريط الإنشاء، يمكن للمستخدمين تصفّح تطبيقات Chat والاطّلاع على أسمائهم وصور الأفاتار الخاصة بهم وأوصافهم.
ضبط تطبيق Chat في Google Cloud Console
بعد الحصول على تفاصيل تطبيق Chat، افتح مشروعك على Cloud واضبط إعدادات Chat API باتّباع الخطوات التالية:
في وحدة تحكّم Google Cloud، انتقِل إلى صفحة Chat API وانقر على صفحة الإعدادات:
ضمن معلومات التطبيق، املأ حقول اسم التطبيق وعنوان URL الخاص بالصورة الرمزية والوصف.
ضمن "الميزات التفاعلية"، انقر على زر التبديل تفعيل الميزات التفاعلية
إلى وضع الإيقاف لإيقاف الميزات التفاعلية في
تطبيق Chat. يمكنك إعداد هذه الميزة لاحقًا. للتعرّف على كيفية إعداد الميزات التفاعلية وإنشائها، يُرجى الاطّلاع على تلقّي تفاعلات المستخدمين والردّ عليها.
اختياري: ضِمن السجلّات، ضَع علامة في مربّع الاختيار تسجيل الأخطاء في Logging لاستخدام Google Cloud Logging. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة سجلّات أخطاء طلب البحث عن تطبيقات Chat.
انقر على حفظ.
منح مستخدمين آخرين الإذن بضبط Chat API
يمكنك
منح مستخدمين محدّدين إذن الوصول
إلى صفحة إعدادات تطبيق Chat من خلال منحهم
دور "مالك تطبيقات Chat" أو دور "مشاهد تطبيقات Chat"في خدمة "إدارة الهوية وإمكانية الوصول" (IAM) من Google Cloud Identity.
لا يمكن للمستخدمين الحاصلين على هذه الأدوار الانتقال إلى صفحة إعدادات تطبيقات Chat باستخدام لوحة بيانات واجهات برمجة التطبيقات والخدمات، ولكن يمكنهم الوصول إلى صفحة الإعدادات من خلال الانتقال إلى Google Cloud Console لمشروع Cloud المضيف لتطبيق Chat على النحو التالي:
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eEvery Google Chat app needs its own Google Cloud project with the Chat API enabled and configured, following specific prerequisites.\u003c/p\u003e\n"],["\u003cp\u003eChat apps require a display name, avatar URL, and description, which are visible to users and used by Chat for attributions.\u003c/p\u003e\n"],["\u003cp\u003eThe Chat API is configured in the Google Cloud console, where you can set the app's details, enable/disable interactive features, and optionally enable error logging.\u003c/p\u003e\n"],["\u003cp\u003eAccess to the Chat app configuration page can be granted to other users via specific Google Cloud IAM roles.\u003c/p\u003e\n"]]],["Each Google Chat app requires a dedicated Google Cloud project with the Chat API enabled. Configuration involves setting up the app's display name (up to 25 characters), avatar URL (square image, 256x256 pixels or more), and description (up to 40 characters). In the Google Cloud console, you must fill out these application details, and optionally, enable or disable interactive features and log errors. Additionally, you can grant specific users access to configure the Chat API by assigning them the \"Chat apps Owner\" or \"Chat apps Viewer\" IAM roles.\n"],null,["# Configure the Google Chat API\n\nEach Google Chat app that you create requires its own\nGoogle Cloud project with the Chat API enabled and configured. This page\nshows you how to configure the Chat API.\n\nPrerequisites\n-------------\n\n- A Business or Enterprise [Google Workspace](https://support.google.com/a/answer/6043576) account with access to [Google Chat](https://workspace.google.com/products/chat/).\n- [Create a Google Cloud project](/workspace/guides/create-project).\n- [Configure the OAuth consent screen](/workspace/guides/configure-oauth-consent).\n- [Enable the Google Chat API](/workspace/guides/enable-apis).\n\nChoose a display name, avatar, and description for your Chat app\n----------------------------------------------------------------\n\nWhen you enable the Chat API, you configure the details about your\nChat app that appear to users in Chat,\nincluding a display name, avatar, and description. These details only appear\nin Chat. To publish your Chat app to the\nMarketplace, you must also specify the details that\nappear in your Chat app's\n[Marketplace listing](/workspace/marketplace/create-listing).\n\nTo call the Chat API, you must set up a\nGoogle Chat app with the following information:\n\n| Field | Description | Format |\n|-------------|-----------------------------------------------------|----------------------------------------------------------------------------------------------------------------|\n| App name | The display name for the Chat app. | Up to 25 alphanumeric characters |\n| Avatar URL | The image that displays as your Chat app's avatar. | An HTTPS URL pointing to a square graphics image (PNG or JPEG). Recommended size is 256 by 256 pixels or more. |\n| Description | A brief description of the purpose of the Chat app. | Up to 40 alphanumeric characters |\n\nThe Chat app's name, avatar, and description are\ndisplayed to users in the Chat UI. For some Chat API\nwrite requests, Chat uses this information to attribute the\nactions that a Chat app takes in Chat.\n\nFor example, if you call the `spaces.create()` method, Chat\nincludes the name of the Chat app in the\ndescription of who created the space, as shown in the following image:\n**Figure 1** . The attribution message that Chat displays when the `spaces.create()` method is used to create a space on behalf of a user.\n\nTo interact with Chat apps, users can also see or use this\ninformation in the following ways:\n\n- Invoke the Chat app by @mentioning its name.\n- Find and start a direct message with the Chat app. In the **Apps** menu, direct messages display the Chat app's name and avatar.\n- From the compose bar, users can browse Chat apps and see their name, avatar, and description.\n\nConfigure your Chat app in the Google Cloud console\n---------------------------------------------------\n\nWhen you have your Chat app details, open your\nCloud project and configure the Chat API:\n\n1. In the Google Cloud console, go to the Chat API page and click the\n **Configuration** page:\n\n [Go to Chat API Configuration page](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat)\n2. Under **Application info** , fill out the **App name** , **Avatar URL** ,\n and **Description** fields.\n\n3. Under Interactive features, click the **Enable interactive features** toggle\n to the off position to disable interactive features for the\n Chat app. You can set this up later. To learn about\n configuring and building interactive features, see\n [Receive and respond to user interactions](/workspace/chat/receive-respond-interactions).\n\n4. Optional: Under **Logs** , select the **Log errors to Logging** checkbox to\n use Google Cloud Logging. For more information, see\n [Query error logs for Chat apps](/workspace/chat/query-logs).\n\n5. Click **Save**.\n\nGrant other people permission to configure the Chat API\n-------------------------------------------------------\n\nYou can\n[give specific users access](https://cloud.google.com/iam/docs/granting-changing-revoking-access#single-role)\nto the Chat app configuration page by granting them\nthe **Chat apps Owner** or **Chat apps Viewer**\n[Google Cloud Identity Access Management (IAM) role](https://cloud.google.com/iam/docs/understanding-roles#chat-roles).\nUsers with these roles can't navigate to the Chat apps\nconfiguration page by using the **APIs \\& Services** dashboard, but can\naccess the configuration page by navigating to the Google Cloud console for the\nChat app's host Cloud project as follows: \n\n```\nhttps://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID\n```\n\nWhere \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is the project ID of the\nGoogle Cloud project hosting the Chat app.\n| Users with **Project** roles can also access the app configuration page.\n|\n|\n| Users with custom roles containing the\n| `resourcemanager.projects.(get|update)` permissions cannot access\n| the Chat app configuration. For custom roles, use\n| the `chat.bots.(get|update)` permissions instead.\n\nRelated topics\n--------------\n\n- [Choose a Chat app architecture](/workspace/chat/structure)\n- To configure your Chat app for interactive features, see [Receive and respond to user interactions](/workspace/chat/receive-respond-interactions)"]]
