الرموز المميزة للجلسة

اختَر النظام الأساسي: Android iOS JavaScript خدمة الويب

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

نوصي بالإرشادات التالية:

  • استخدم الرموز المميزة للجلسة لجميع جلسات الإكمال التلقائي.
  • إنشاء رمز مميّز جديد لكل جلسة
  • تأكَّد من أنّ مفاتيح واجهة برمجة التطبيقات المستخدَمة لجميع طلبات "الإكمال التلقائي" و"تفاصيل المكان" ضمن جلسة معيّنة تنتمي إلى مشروع Google Cloud Console نفسه.
  • تأكد من تمرير رمز مميز فريد للجلسة لكل جلسة جديدة. سيؤدي استخدام الرمز المميّز نفسه لأكثر من جلسة إلى تحصيل رسوم كل طلب على حدة.

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

مثال

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

لنفحص تدفق الأحداث هذا من منظور التطبيق.

  1. يبدأ مستخدم في كتابة طلب بحث عن "باريس، فرنسا".
  2. عند رصد البيانات التي أدخلها المستخدم، ينشئ التطبيق رمزًا مميزًا جديدًا للجلسة، وهو "الرمز المميّز أ".
  3. أثناء كتابة المستخدمين، تُجري واجهة برمجة التطبيقات طلب إكمال تلقائي كل بضعة أحرف، وتعرض قائمة جديدة بالنتائج المحتملة لكل من:
    "P"
    "Par"
    "باريس"،
    "باريس، الجمعة"
  4. عندما يختار المستخدم أحد الخيارات:
    • يتم تجميع جميع الطلبات الناتجة عن طلب البحث وإضافتها إلى الجلسة التي يمثّلها الرمز "أ" كطلب واحد.
    • يتم احتساب اختيار المستخدم كطلب للحصول على تفاصيل المكان، وتتم إضافته إلى الجلسة التي يمثّلها الرمز "أ".
  5. تنتهي الجلسة، ويتجاهل التطبيق "الرمز المميز أ".

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

إنشاء الرموز المميّزة للجلسة

لإنشاء رمز مميّز للجلسة، يمكنك استدعاء GMSAutocompleteSessionToken.init().