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

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

يتم تمرير حالة مساحة تخزين المستخدم في طلب app.handle() ويتم تخزينها في الكائن user.

قراءة وكتابة البيانات عبر المحادثات

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

Node.js

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

تنسيق JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "user": {
      "locale": "en-US",
      "params": {
        "verificationStatus": "VERIFIED",
        "exampleColor": "red"
      }
    }
  }
}
    

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

Node.js

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

تنسيق JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "user": {
      "locale": "en-US",
      "params": {
        "verificationStatus": "VERIFIED",
        "exampleColor": "red"
      }
    }
  }
}
    

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

Node.js

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

تنسيق JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "user": {
      "locale": "en-US",
      "params": {
        "verificationStatus": "VERIFIED"
      }
    }
  }
}
    

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

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

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

تنسيق JSON

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

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

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

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

بنية الشرط

user.params.exampleColor == "red"
    

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

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

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

في ما يلي الأسباب المحتملة التي تؤدي إلى ظهور حالة إثبات الهوية للمستخدم GUEST:

  • تم إيقاف النتائج الشخصية للمستخدم.
  • أوقَف المستخدم النشاط على الويب وفي التطبيقات. ضع في اعتبارك أنه قد يتم تعطيل هذا الإعداد لدى بعض المستخدمين على مستوى النطاق.
  • إذا كانت ميزة Voice Match مفعّلة على جهاز، وتعذّرت المطابقة أو استدعى المستخدم "مساعد Google" بدون استخدام الصوت (مثل الضغط مع الاستمرار على جهاز Nest Home).
  • لم يسجّل المستخدم الدخول.

تحقق دائمًا من حالة التحقق للمستخدم قبل تخزين البيانات بمساحة تخزين المستخدم لمنع الضيوف الضيوف من التفاعل مع ميزة ستفشل بالنسبة لهم.

مستوى الرؤية للمستخدمين

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

لعرض بياناتك المخزنة أو منع إحدى الخدمات من تذكرك، اتبع الخطوات التالية:

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