سيتم إيقاف واجهة برمجة تطبيقات المعاملات في 3 أيار (مايو) 2023، قبل إيقاف ميزة "إجراءات المحادثات" في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
تحديد وحلّ المشاكل في المعاملات المادية (Dialogflow)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إذا كنت تواجه مشكلة في تحقيق نوايا الشراء باستخدام الإجراء الخاص بك، اطّلِع على
أنك تعاني من أي من الأعراض الموضحة في الأقسام التالية
اتّخاذ الخطوات المقترَحة لتحديد المشاكل وحلّها.
الإجراء لا يستجيب
العرَض: عند تفعيل هدف لإجراء المعاملات (TransactionRequirements، TransactionDecision)، يسترد المستخدم ردّ "التطبيق لا يستجيب في الوقت الحالي. يُرجى إعادة المحاولة بعد قليل."
تحديد المشاكل وحلّها: تأكَّد من أنّ مشروع الإجراء الخاص بك يتضمّن جميع معلومات الدليل المطلوبة، بما في ذلك رابط لسياسة الخصوصية.
تعذّرت معالجة الإيصال
المشكلة: أثناء تفويض الشراء، يتلقى المستخدم ردًا مفاده.
"لا يمكنني معالجة الإيصال."
تحديد المشاكل وحلّها:
- يُرجى التأكّد من أنّ قيمة
merchantOrderId فريدة. لا يمكن تقديم طلب جديد
بمُعرّف طلب سابق حالي.
- تأكد من إرسال رد بسيط
جنبًا إلى جنب مع قيمة
orderUpdate الأولية؛ فهذا هو تنسيق الرد الإلزامي.
تعذّر إرسال تحديثات الطلب
المشكلة: عند إرسال تعديل لطلب حالي، تعمل واجهة برمجة التطبيقات Orders API على
تستجيب مع ظهور رمز الخطأ 500 ورسالة الخطأ التالية: "الطلب OrderID
تعذر تحديث المشروع ProjectID. يُرجى إعادة المحاولة."
تحديد المشاكل وحلّها:
عدم ظهور التعديلات على الطلبات كإشعارات
المشكلة: يتم تقديم الطلب المبدئي وتنجح تعديلات الطلب من خلال
رمز الحالة 200 ولكنّه لا يظهر كإشعارات فورية في الأجهزة المزوّدة بخدمة "مساعد Google" لدى المستخدم
الخاص بك.
تحديد المشاكل وحلّها: لن تظهر كل التعديلات على الطلب كإشعار فوري.
التحديثات فقط بالحالة CANCELLED أو FULFILLED أو REJECTED أو RETURNED
إلى إرسال إشعار.
عرض المعاملات في حسابك
يمكنك الاطّلاع على المعاملات التي تمّ إجراؤها من خلال حسابك باتّباع الخطوات التالية:
- انتقِل إلى myaccount.google.com وسجِّل الدخول.
- انقر على الدفعات و الاشتراكات في القائمة اليمنى.
- ضمن عمليات الشراء، انقر على إدارة عمليات الشراء.
يمكنك أيضًا عرض المعاملات في وضع الحماية من خلال إضافة معلَمة طلب البحث التالية لعنوان URL:
myaccount.google.com/purchases?sandbox=1
نصائح أخرى لتحديد المشاكل وحلّها
إذا لم تصف الأعراض أعلاه المشكلة التي تواجهها، فقد
تريد الرجوع إلى سجلات Stackdriver في مشروعك
للحصول على مزيد من خطوات استكشاف الأخطاء وإصلاحها. يمكنك أيضًا الرجوع إلى إعدادات حسابك على Google.
لعرض وإدارة أي عمليات شراء أجريتها باستخدام الإجراء الخاص بك.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis troubleshooting guide helps you resolve issues when users can't complete transactions with your Action.\u003c/p\u003e\n"],["\u003cp\u003eCommon problems include the Action not responding, issues processing receipts, difficulties sending or receiving order updates, and viewing transaction history.\u003c/p\u003e\n"],["\u003cp\u003eSolutions involve verifying Action settings, ensuring unique order IDs, using correct response formats, and checking authentication credentials.\u003c/p\u003e\n"],["\u003cp\u003eOrder update notifications are only sent for specific status changes like cancellations, fulfillments, rejections, or returns.\u003c/p\u003e\n"],["\u003cp\u003eFor further assistance, consult Stackdriver logs or review your Google Account settings for purchase history and management.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting Physical Transactions (Dialogflow)\n\nIf you're having trouble fulfilling transaction intents with your Action, see if\nyou're experiencing any of the symptoms described in the following sections and\ntake the recommended troubleshooting steps.\n\nAction not responding\n---------------------\n\n**Symptom:** When triggering a transactions intent (`TransactionRequirements`, `TransactionDecision`), the user gets back a response of *\"App isn't responding at the moment. Try again soon.\"*\n\n**Troubleshooting:** Ensure your Action project has all the required directory information, including a privacy policy link.\n\nUnable to process receipt\n-------------------------\n\n**Symptom:** During purchase authorization, the user gets a response saying\n\"*Sorry, I am unable to process your receipt.*\"\n\n**Troubleshooting:**\n\n- Make sure your `merchantOrderId` is unique. A new order can't be placed with a previous, existing order ID.\n- Make sure you're sending a [simple response](/assistant/conversational/responses#simple_responses) alongside the initial `orderUpdate`; this is the mandatory response format.\n\nUnable to send order updates\n----------------------------\n\n**Symptom:** When sending an order update for an existing order, the Orders API\nresponds with error code 500 and the following error message: \"*Order `OrderID`\nfor project `ProjectID` could not be updated. Please try again.*\"\n\n**Troubleshooting:**\n\n- Make sure you're supplying working credentials during [JWT authentication for\n the Orders API](https://github.com/google/google-api-nodejs-client#using-jwt-service-tokens).\n\nOrder updates not appearing as notifications\n--------------------------------------------\n\n**Symptom:** Initial order is placed and follow-up order updates succeed with\nstatus code 200 but don't appear as push notifications on the user's Assistant-enabled\ndevice.\n\n**Troubleshooting:** Not all order updates will be reflected as a push notification;\nonly updates with a status of `CANCELLED`, `FULFILLED`, `REJECTED`, or `RETURNED`\nresult in a notification.\n\nView transactions on your account\n---------------------------------\n\nYou can view transactions that have been made through your account by following these steps:\n\n1. Navigate to [myaccount.google.com](/assistant/df-asdk/transactions/physical/myaccount.google.com) and log in.\n2. Click **Payments \\& subscriptions** in the left menu.\n3. Under **Purchases** , click **Manage purchases**.\n\nYou can also view sandbox transactions by adding the following URL query parameter: \n\n```text\nmyaccount.google.com/purchases?sandbox=1\n```\n\nOther troubleshooting tips\n--------------------------\n\nIf the above symptoms don't describe the problem you're running into, you may\nwant to refer to your project's [Stackdriver logs](/assistant/console/troubleshooting)\nfor further troubleshooting. You can also refer to your [Google Account settings](https://myaccount.google.com/preferences?pli=1#subscriptions)\nto view and manage any purchases you've made with your Action."]]
