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

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

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

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

القيود

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

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

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

ملاحظة: عند استخدام مساحة التخزين في المنزل، تقدِّم Google أيضًا بيان إخلاء مسؤولية مرة إلى المستخدمين الذين تم إثبات ملكيتهم، وفي كل استدعاء للمستخدمين الضيوف (ما يصل إلى مرة واحدة كل 10 دقائق).

قراءة وكتابة البيانات في الأسرة

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

Node.js

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

تنسيق JSON

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

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

Node.js

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

تنسيق JSON

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

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

Node.js

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

تنسيق JSON

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

الإشارة إلى القيم المخزّنة ضمن الإشعارات

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

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

تنسيق JSON

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

الإشارة إلى القيم المخزّنة في ظل شروط

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

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

بنية الشرط

home.params.exampleColor == "red"
    

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

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

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

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

ملاحظة: يؤدي محو مساحة التخزين في المنزل إلى محو القيم المخزَّنة للضيوف وغيرهم من مدراء بنية الرسم البياني للمنزل.

وعندما يفصل مدير جهاز الجهاز عن البنية، يتم فصل عناصر التخزين المنزلية. وستبقى بيانات مساحة التخزين المنزلية مرتبطة بالجهاز حتى إذا تغيّر مدير البنية، ما لم يمحوه مدير البنية.

بيانات مساحة التخزين في المنزل في "محاكي Google"

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

نموذج للتفاعل

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

طلب بحث المستخدم	Ok Google، أريد التحدّث إلى ExampleAction
ردّ "مساعد Google"	الحصول على ExampleAction
ردّ "مساعد Google"	يُرجى العِلم أنّ ExampleAction يتم حفظه في كل مرة يتم فيها تشغيل اللعبة، حتى يتمكن أفراد الأسرة الآخرون من المتابعة من حيث توقفت.
استجابة exampleAction	مرحبًا، أنت في المستوى 0. يُرجى قول التالي أو إعادة الضبط أو الإلغاء.
طلب بحث المستخدم	التالي.
استجابة exampleAction	أنت في المستوى 1.
طلب بحث المستخدم	مغادرة.

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

طلب بحث المستخدم	Ok Google، أريد التحدّث إلى ExampleAction
ردّ "مساعد Google"	الحصول على ExampleAction
استجابة exampleAction	مرحبًا، أنت في المستوى 1. يُرجى قول التالي أو إعادة الضبط أو الإلغاء.
طلب بحث المستخدم	التالي.
استجابة exampleAction	أنت في المستوى 2.
طلب بحث المستخدم	مغادرة.

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

ملاحظة: لا تقدّم Google بيان إخلاء المسؤولية إلا إذا مرّت 10 دقائق على الأقل منذ آخر استدعاء للإجراء في هذا الأسرة.

طلب بحث المستخدم	Ok Google، أريد التحدّث إلى ExampleAction
ردّ "مساعد Google"	الحصول على ExampleAction
ردّ "مساعد Google"	يُرجى العِلم أنّ ExampleAction يتم حفظه في كل مرة يتم فيها تشغيل اللعبة، حتى يتمكن أفراد الأسرة الآخرون من المتابعة من حيث توقفت.
استجابة exampleAction	مرحبًا، أنت في المستوى 2. يُرجى قول التالي أو إعادة الضبط أو الإلغاء.
طلب بحث المستخدم	التالي.
استجابة exampleAction	أنت في المستوى 3.
طلب بحث المستخدم	مغادرة.