انتقل إلى المحتوى
Sursa Developers

الكائنات

AnswerWarning

تحذير مرفق بإجابة. الحقل kind قابل للتوسيع: اعرض النوع غير المعروف برسالة عامة. الأنواع:
- الأنواع chart_unavailable، وchart_type_changed، وchart_axis_categorical، وtool_not_allowed، وtool_failed، وtable_query_failed (فشل أحد استعلامات الجداول في الإجابة)، وtruncated. لا يوجد الحقل reason في هذه الأنواع.

- النوع answer_mismatch_data: رقم في الإجابة بجوار شهر يختلف عن بيانات المخطط لذلك الشهر (reason: period_value، period_missing، total_as_period، period_part)؛ أو الرقم غير موجود في بيانات الإجابة (reason: number_not_in_data)؛ أو إجابة النظرة العامة تذكر مستندًا ليس في قائمة المستندات وليس له رابط مصدر (reason: document_not_in_list)؛ أو الرقم موجود في البيانات لكن بعملة أخرى (reason: currency_mismatch، مع الحقول number وcurrency وcurrencies). الحقول: text، وexpected، وspans.

- النوع answer_source_ambiguous: البيانات مأخوذة من عدة جداول متشابهة للفترة نفسها، ولم يطلب السؤال دمجها (يسرد text الجداول).

- النوع answer_no_data_basis: إجابة فيها أرقام شهرية ليست لها بيانات جدولية، لذا لم يُتحقق من الأرقام.

- النوع currency_missing: رقم من بيانات نقدية بلا عملة، مع أن البيانات فيها عدة عملات (text، number، spans، currencies).

- النوع mixed_currency_sum: رقم في الإجابة يساوي مجموع قيم بعملات مختلفة (text، number، spans، currencies).

- النوع access_limited: استُبعدت بعض النتائج بسبب صلاحيات وصول المستخدم، لذا قد تكون الإجابة غير مكتملة (بلا حقول بيانات).

- النوع fx_rate_stale: استخدم التحويل سعر صرف أقدم من عتبة الحداثة لمصدره (rate_date، currencies).

- النوع fx_rate_missing: لم يُحوَّل مبلغ في الإجابة. قيمة reason هي no_rate_on_date (لا يوجد سعر لتاريخ صف المبلغ ضمن هامش السماح: 7 أيام، أو 31 يومًا للأسعار المرفوعة يدويًا) أو no_rate (لا توجد أسعار للزوج إطلاقًا). يسرد currencies العملات التي بلا سعر. وtext نص احتياطي بالإنجليزية فيه الأزواج والتواريخ، مثل «RUB → USD on 2026-03-04, 2026-03-05»، والأزواج المتعددة مفصولة بالرمز «; ».

- النوع restricted_unverified: سؤال في موضوع مقيَّد. لا تُعرض المقتطفات بلا فحص للصلة (بلا حقول بيانات).

- النوع enrichment_pending: في نطاق السؤال مستندات لا تزال قيد المعالجة، لذا حقولها وسجلاتها المالية ليست جاهزة. قيمة reason هي documents (سؤال عن مبالغ أو إجابة من جداول، لذا قد يكون الإجمالي غير مكتمل) أو document (سؤال عن مستند محدد لا يزال قيد المعالجة أو تعذرت معالجته). الحقل pending عدد المستندات قيد المعالجة، وcard_ids المرئية منها للمستخدم (20 على الأكثر). والحقل failed عدد المستندات التي تعذرت معالجتها، وfailed_card_ids المرئية منها (20 على الأكثر).

- النوع partial_coverage: سؤال ملف شامل أو قائمة مستندات من نوع واحد. عُثر على found مستند في النطاق، ولا يرد في الإجابة إلا shown < found، لذا قد تكون الإجابة غير مكتملة.

- النوع reconcile_unconfirmed: تقول الإجابة «متطابق» عن سؤال مطابقة، لكن المبلغ لم يُعثر عليه في مستندين مختلفين (text ملاحظة فيها مبالغ المصدرين بلغة الإجابة).

يبني العميل النص المعروض للمستخدم من kind وreason وحقول البيانات بلغة الواجهة. أما text في access_limited وrestricted_unverified وfx_rate_missing، وexpected، فنصوص احتياطية بلغة الإجابة أو بالإنجليزية.

الحقول

  • kindstringمطلوب
  • reasonstring

    للنوع answer_mismatch_data: رمز السبب (period_value، period_missing، total_as_period، period_part، number_not_in_data، document_not_in_list، currency_mismatch). وللنوع chart_axis_categorical: unparsed_periods. وللأنواع tool_failed وtable_query_failed وtruncated: لا يوجد reason. وللنوعين currency_missing وmixed_currency_sum: شرح بالإنجليزية (احتياطي؛ ويبني العميل العبارة من currencies). وللنوع fx_rate_missing: no_rate_on_date (لا يوجد سعر لتاريخ الصف ضمن هامش السماح) أو no_rate (لا توجد أسعار للزوج إطلاقًا).

  • requestedstring
  • typestring
  • toolstring

    للنوعين tool_failed وtool_not_allowed: اسم الأداة.

  • textstring

    جزء الإجابة الذي يخصه التحذير (للنوع answer_mismatch_data: الشهر والرقم كما كُتبا في الإجابة). وللأنواع access_limited وrestricted_unverified وfx_rate_missing، نص احتياطي (للنوع fx_rate_missing: الأزواج والتواريخ التي بلا سعر).

  • expectedstring

    ما تقوله البيانات (للنوع answer_mismatch_data: قيمة هذا الشهر وشهر هذه القيمة، أو قيمة الإجمالي).

  • spansarray of array of integer

    مواضع العبارات في نص الإجابة (UTF-16، كما في سلاسل JavaScript): الرقم والشهر.

  • numberstring

    للنوع answer_mismatch_data: الرقم كما كُتب في الإجابة. ومع period وother_period وvalues وrows، هذه هي بيانات نص التحذير بلغة الواجهة.

  • periodstring

    للنوع answer_mismatch_data: الشهر من الإجابة (YYYY-MM).

  • other_periodstring

    للنوع answer_mismatch_data: شهر البيانات الذي تساوي قيمته الرقم (YYYY-MM).

  • valuesarray of number (double)

    للنوع answer_mismatch_data: قيم البيانات للشهر، أو الإجمالي.

  • rowsinteger

    للنوع answer_mismatch_data والسبب period_part: عدد الصفوف التي جُمعت في إجمالي الشهر.

  • currencystring

    للنوع answer_mismatch_data والسبب currency_mismatch: عملة الرقم كما سُمّيت في الإجابة (رمز ISO 4217).

  • currenciesarray of string

    عملات البيانات (رموز ISO 4217). للسبب currency_mismatch، العملات التي ترد بها هذه القيمة في البيانات؛ وللنوعين currency_missing وmixed_currency_sum، عملات القيم النقدية في بيانات الإجابة؛ وللنوع fx_rate_stale، العملات المحوَّلة بسعر قديم؛ وللنوع fx_rate_missing، العملات التي بلا سعر.

  • rate_datestring (date)

    للنوع fx_rate_stale: تاريخ السعر القديم (YYYY-MM-DD).

  • pendinginteger

    للنوع enrichment_pending: عدد المستندات في نطاق السؤال التي لا تزال قيد المعالجة.

  • card_idsarray of string

    للنوع enrichment_pending: بطاقات هذه المستندات المرئية للمستخدم (20 على الأكثر).

  • failedinteger

    للنوع enrichment_pending: عدد المستندات في نطاق السؤال التي تعذرت معالجتها.

  • failed_card_idsarray of string

    للنوع enrichment_pending: بطاقات المستندات التي تعذرت معالجتها والمرئية للمستخدم (20 على الأكثر).

  • foundinteger

    للنوع partial_coverage: عدد المستندات المطلوبة التي عُثر عليها في نطاق السؤال.

  • showninteger

    للنوع partial_coverage: عدد المستندات المعثور عليها الواردة في الإجابة.

جزء من

AnswerResponseChatEventDataFeedItemQuestionPayload