مساحة التخزين في المنزل

في مكالمة الردّ التلقائي على الويب، يمكنك تخزين قيم المَعلمات على مستوى جلسات متعددة في الأسرة نفسها (استنادًا إلى الرسم البياني المنزلي) في مساحة التخزين المنزلية. ويمكن عندئذٍ للإجراء الخاص بك استخدام تلك القيم المخزّنة لاحقًا في الطلبات والشروط، ويمكن لرمز الرد التلقائي على الويب الوصول إلى القيم في مساحة التخزين المنزلية لأسرة معيّنة عند الضرورة.

يتم تمرير حالة التخزين المنزلي في طلب app.handle()، ويتم تخزينها في العنصر home.

القيود

ولا يمكن استخدام التخزين المنزلي مع الأجهزة الجوّالة، لأنّها ليست جزءًا من الرسم البياني المنزلي. في رمز الرد التلقائي على الويب، استخدِم إمكانية استخدام الجهاز HOME_STORAGE لتفريع منطق النشاط التجاري استنادًا إلى ما يمكن لجهاز المستخدم فعله.

عليك الموافقة على استخدام مساحة التخزين المنزلية:

1. في وحدة تحكُّم الإجراءات، انتقِل إلى نشر > معلومات الدليل.
2. في قسم معلومات إضافية، ضَع علامة في مربّع التخزين المنزلي.

قراءة البيانات وكتابتها في المنزل

لتعديل قيمة جديدة أو ضبطها في مساحة التخزين المنزلية، يجب تخصيص القيمة للحقل params للعنصر home في مكالمة الردّ التلقائي على الويب. يقوم المثال التالي بتعيين "exampleColor" على "red" في وحدة التخزين المنزلية:

// Assign color to home storage
app.handle('storeColor', conv => {
  let color = 'red';
  conv.home.params.exampleColor = color;
});
    

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "home": {
      "params": {
        "exampleColor": "red"
      }
    }
  }
}
    

للوصول إلى البيانات المخزَّنة في مساحة التخزين المنزلية، يمكنك تخصيصها لمتغيّر في مكالمة ردّ تلقائي على الويب. يسترد المثال التالي قيمة من "exampleColor" في التخزين المنزلي:

// Retrieve color from home storage
app.handle('getStoredColor', conv => {
  let color = conv.home.params.exampleColor;
});
    

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "home": {
      "params": {
        "homeColor": "red"
      }
    }
  }
}
    

لمحو قيمة محفوظة سابقًا، اضبط القيمة على null في مكالمة ردّ تلقائي على الويب. يمحو المثال التالي قيمة "exampleColor" في مساحة التخزين المنزلية:

// Clear color from home storage
app.handle('clearStoredColor', conv => {
  conv.home.params.exampleColor = null;
});
    

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "home": {
      "params": {}
    }
  }
}
    

الإشارة إلى القيم المخزنة ضمن الطلبات

يمكنك الإشارة إلى القيم المخزَّنة في مساحة التخزين المنزلية في طلب. للإشارة إلى القيمة، استخدِم البنية $home.params.PARAMETER_NAME، حيث يكون PARAMETER_NAME هو الاسم المحدّد في الردّ التلقائي على الويب عند ضبط المَعلمة.

على سبيل المثال، سبق لك تخزين قيمة لون في وحدة التخزين المنزلية كالمعلّمة exampleColor. للوصول إلى هذه القيمة في طلب، عليك الإشارة إلى تلك القيمة باستخدام $home.params.exampleColor:

{
  "candidates": [{
    "first_simple": {
      "variants": [{
        "speech": "Your favorite color is $home.params.exampleColor."
      }]
    }
  }]
}
    

الإشارة إلى القيم المخزنة ضمن الشروط

يمكنك أيضًا الإشارة إلى القيم المخزَّنة في مساحة التخزين المنزلية في قسم conditions. للإشارة إلى القيمة، استخدِم البنية home.params.PARAMETER_NAME، حيث يكون PARAMETER_NAME هو الاسم المحدّد في الردّ التلقائي على الويب عند ضبط المَعلمة.

على سبيل المثال، سبق لك تخزين قيمة لون في وحدة التخزين المنزلية كالمعلّمة exampleColor، وتريد مطابقتها مع القيمة "red" في شرط معيّن. في شرطك، تشير إلى القيمة المخزّنة باستخدام home.params.exampleColor. بعد ذلك يبدو تعبير الشرط كما يلي:

home.params.exampleColor == "red"
    

انتهاء صلاحية بيانات مساحة التخزين المنزلية

يتم حجب بيانات مساحة التخزين المنزلية بعد 90 يومًا متتالية من عدم استدعاء الإجراء. ويؤدي استدعاء الإجراء على أي جهاز مرتبط ببنية الرسم البياني المنزلي إلى إعادة ضبط موقّت مدته 90 يومًا. إذا تم حذف هيكل الرسم البياني المنزلي، فسيتم محو بيانات التخزين المنزلي المقابلة.

بالنسبة إلى الإجراءات التي تستخدم مساحة التخزين في المنزل، يمكن لمديري بنية الرسم البياني المنزلي محو مساحة التخزين الرئيسية للبُنى التي يديرونها من صفحة الإجراء في دليل "مساعد Google":

1. ابحث عن الإجراء الذي تريد عرضه أو محو مساحة تخزين المستخدم له واختَره.
2. انتقِل إلى أسفل الصفحة:
   • لإزالة البيانات المخزَّنة لك في مساحة التخزين المنزلية، انقر على إيقاف action_name من تذكّرني.

عندما يفصل مدير الجهاز الجهاز عن البنية، يتم أيضًا فصل مساحة التخزين المنزلية. يستمر ربط بيانات مساحة التخزين المنزلية بأي جهاز حتى في حال تغيير مدير البنية، ما لم يمحوها مدير البنية.

بيانات التخزين المنزلي في المحاكي

عند اختبار الإجراء الخاص بك باستخدام المحاكي في وحدة تحكّم المهام، يختلف سلوك البيانات المخزّنة في مساحة التخزين المنزلية بشكل طفيف عن الأجهزة الفعلية. ويُعد المحاكي جزءًا من الرسم البياني المنزلي التابع له، لذا لا تنحصر البيانات في الأجهزة الأخرى التي قد تكون لديك في شبكتك. بالإضافة إلى ذلك، لا يتم الاحتفاظ ببيانات مساحة التخزين المنزلية في الجلسات عند تفعيل إعداد محاكي محاكاة مستخدم لم يتم إثبات ملكيته.

نموذج تفاعل

إليك نموذج تفاعل لمستخدم سجّل الدخول عند استدعائه للمرة الأولى بالإجراء:

بعد ذلك، عندما يعود المستخدم الذي تم التحقّق من هويته نفسه إلى الإجراء بعد مرور بعض الوقت:

في اليوم التالي، يتفاعل مستخدم لم يتم التحقّق منه مع "الإجراء" على جهاز آخر ضمن المنزل نفسه (كما هو محدَّد في قاعدة البيانات Home Graph).