سيتم إيقاف واجهة برمجة تطبيقات المعاملات في 3 أيار (مايو) 2023، قبل إيقاف ميزة "إجراءات المحادثات" في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
إرشادات التصميم
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
صمم محادثة لتوجيه المستخدمين خلال تدفقات
المعاملات. لقد قدمنا أمثلة مرجعية يمكنك استخدامها كدليل
عند تصميم إجراءات المعاملات الخاصة بك.
أمثلة
نصائح التصميم
واحرِص على أن تبدو الحوارات
طبيعية وتحاورية،
كما يجب أن يتحدّث بها أي شخص حقيقي.
لا يجب أن يتطابق النص المكتوب بصوت "تحويل النص إلى كلام" (TTS) أو الصوت تمامًا مع النص
المعروض في فقاعات المحادثة. ستعمل بشكل جيد إذا كانت فقاعات الدردشة عبارة عن مجموعة
فرعية من الحوار المنطوق.
رحِّب بالزوّار وحافِظ على تفاعلهم. اسأل عما يحتاج إليه وقدم بعض
رقائق الاقتراحات لبدء الاستخدام.
قبل دعوة المستخدم لإضافة سلع إلى سلة التسوّق، يُرجى إجراء فحص للخلفية من خلال إضافة ملء الخانة واستخدام نوع الشريحة actions.type.TransactionRequirementsCheckResult للتأكّد من أنّ المستخدم لديه عمليات دفع تم إعدادها لخدمة "مساعد Google".
كن مستعدًا للرد على مشكلات الصوت نفسها كما هو الحال مع تجارب الويب
أو الهاتف المحمول الأخرى. على سبيل المثال، يمكنك تقديم سلعة مماثلة عندما لا تتوفّر لديك مقاس أو لون محدّد، أو دعوة المستخدمين للاشتراك ليتم إرسال إشعار إليك عند توفّر السلعة من جديد.
يتم إنشاء ملخّص الطلب باستخدام البيانات التي يتم نقلها عبر واجهة برمجة التطبيقات.
يساعد تصنيف "الدفع من الحساب في Google" المستخدمين في معرفة أنّ Google قد سهّلت
عملية الدفع.
عند طلب معلومات من المستخدمين، مثل معلومات العنوان،
يجب إخبارهم أولاً بسبب تقديم الطلب وكيف سيستفيدون منه.
ستعرض Google طريقة تفويض الشراء (إما لا يلزم المصادقة أو كلمة مرور أو بصمة إصبع) استنادًا إلى إعدادات المستخدم. في بعض الأحيان،
يبدأ تقييم المخاطر لدينا في خطوة مصادقة إضافية مثل تأكيد
قيمة التحقق من البطاقة (CVV) للبطاقة.
بعد اكتمال الدفع، تأكد من إرسال إيصال وتأكيد الطلب. من المهم أن يفهم المستخدمون أنك الجهة المسؤولة عن معالجة الدفعات،
ويتابعون معك كل التفاصيل المتعلقة بالطلب وليس Google.
وفقًا للإعدادات التلقائية، يمكن إجراء المعاملات على سطح شاشته (مثل هاتف Android) أو على سطح مزود بالصوت فقط (مثل Google Home).
لإتاحة المعاملات الصوتية فقط على أفضل نحو ممكن، يجب الحرص بشكل أكبر على تصميم تجربة محادثات جيدة توجّه المستخدمين إلى تجربة المعاملات الكاملة.
يُرجى العِلم أنّ بعض أهداف المعاملات قد تتطلّب شاشة. سيتم تسليم معظم هذه العناصر
(على سبيل المثال، إضافة عنوان تسليم جديد، أو إصلاح مشاكل الدفع، وربط الحسابات)
إلى الهاتف تلقائيًا. إذا كان من الأفضل عرض أي إضافات إلى المحادثة على الشاشة
(مثل تقديم ردود منسّقة لإنشاء البطاقة أو عرض بنود خدمة التاجر أو سياسة الخصوصية الخاصة بالتاجر)، عليك التحقق مما إذا كانت مساحة العرض الحالية تتوافق مع
إمكانات RICH_RESPONSE أو WEB_LINK
ونقلها إلى مساحة عرض جديدة في حال عدم توفّرها.capabilities
إذا كنت تفضِّل عدم إتاحة المعاملات الصوتية فقط مع الإجراء الخاص بك، يمكنك ضبط
مشروعك على "المهام" بحيث يتطلّب شاشة من خلال
الانتقال إلى النشر > إمكانيات السطح في
وحدة تحكّم المهام وضبط
هل تتطلّب الإجراءات الخاصة بك إخراج شاشة على نعم.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDesign conversational transactional flows, similar to natural human interactions, guiding users through the process.\u003c/p\u003e\n"],["\u003cp\u003eUtilize provided examples and design tips to create effective and user-friendly transactional Actions.\u003c/p\u003e\n"],["\u003cp\u003eEnsure clear communication, address potential issues proactively, and inform users about Google's role in payment processing.\u003c/p\u003e\n"],["\u003cp\u003eOptimize for both screen and voice-only interactions by tailoring the conversation and utilizing surface capabilities effectively.\u003c/p\u003e\n"],["\u003cp\u003eCustomize the user experience by enabling or disabling screen requirements based on your Action's functionalities.\u003c/p\u003e\n"]]],[],null,["# Design guidelines\n\nDesign a conversation to guide users through your transactional\nflows. We've provided reference examples that you can use as a guide\nwhen designing your own transactional Actions.\n\nExamples\n--------\n\n[](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) [Shoe store Example](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) \n[](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) [Ticketing example](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) \n[](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA) [Flower Shop Example](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA)\n\nDesign tips\n-----------\n\n- Make sure the dialogs\n [sound natural and conversational](/assistant/conversational/df-asdk/design)\n --- the way a real person would talk.\n\n- The text spoken by your TTS/voice does not have to exactly match the text\n shown in your chat bubbles. It works well if the chat bubbles are a subset\n of the spoken dialog.\n\n- Greet your visitors and get them engaged. Ask what they need and offer a\n few suggestion chips to get them started.\n\n- Before inviting the user to add items to the cart, do a backend check by\n adding slot filling and using the `actions.type.TransactionRequirementsCheckResult`\n slot type to confirm the user has payments set up for their Google Assistant.\n\n- Be prepared to respond to the same issues with voice as with other mobile\n or web experiences. For example, offer a similar item when you're out of a\n certain size or color, or invite users to sign up to be notified when the\n item is back in stock.\n\n- Note that the order summary is built with the data you pass via the API.\n The \"Pay with Google\" label helps users understand that Google facilitated\n the payment.\n\n- When requesting info from your users, like their address info, first let\n them know why you are making the request and how it will benefit them.\n\n- Google will present the purchase authorization method (either no auth\n required, password, or fingerprint) based on the user's settings. Sometimes\n our risk assessment will kick off an additional auth step like confirming\n CVV for a card.\n\n- After the payment is complete, be sure to send a receipt and an order\n confirmation. It's important that users understand that you are the merchant\n of record, and will follow up with all details about the order, not Google.\n\n- By default transactions can be performed on either a surface with a\n screen (such as an Android phone) or a voice-only surface (such as a Google Home).\n\n - To best support voice-only transactions, take extra care to design\n a [good conversational experience](/assistant/conversational/df-asdk/design)\n that walks users through the full transaction experience.\n\n - Note that some transactions intents may require a screen. Most of these\n (e.g. adding a new delivery address, fixing payment issues, account linking)\n will be handed off to the phone automatically. If there are any additions\n to the conversation that are best displayed on a screen\n (e.g. presenting rich responses for card building, displaying a merchant\n ToS or privacy policy), you should check if the current surface supports\n the `RICH_RESPONSE` or `WEB_LINK`\n [capabilities](/assistant/conversational/reference/rest/v1/TopLevel/fulfill#capability),\n and transfer to a new surface if not.\n\n - If you would rather not support voice-only transactions with your\n Action, you can set your Actions project to require a screen by\n navigating to **Deploy \\\u003e Surface capabilities** in the\n [Actions console](https://console.actions.google.com) and setting\n **Do your Actions require a screen output** to **Yes**."]]
