تستخدم ميزة "الإكمال التلقائي" للأماكن رموزًا مميّزة للجلسة لتجميع طلب البحث والاختيار
لبحث الإكمال التلقائي للمستخدم في جلسة منفصلة لأغراض الفوترة. تبدأ الجلسة عندما يبدأ المستخدم في كتابة طلب بحث، وتنتهي عند اختيار مكان وإجراء مكالمة إلى "تفاصيل المكان". يمكن أن تحتوي كل جلسة على عدة طلبات بحث للإكمال التلقائي، متبوعة باختيار مكان واحد. يجب أن تنتمي مفاتيح واجهة برمجة التطبيقات المستخدمة لكل طلب في الجلسة إلى مشروع Google Cloud Console نفسه. بعد انتهاء الجلسة، لن يصبح الرمز المميز صالحًا
ويجب أن ينشئ تطبيقك رمزًا مميزًا جديدًا لكل جلسة. في حال حذف المعلّمة sessiontoken أو إعادة استخدام الرمز المميز للجلسة، يتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (يتم إصدار فواتير كل طلب بشكل منفصل).
ننصحك باتّباع الإرشادات التالية:
- استخدِم الرموز المميزة للجلسة لكل جلسات الإكمال التلقائي.
- إنشاء رمز مميز جديد لكل جلسة.
- تأكّد من أن مفاتيح واجهة برمجة التطبيقات المستخدَمة لكل طلبات "الإكمال التلقائي" و"مكان" ضمن "الجلسة" تنتمي إلى مشروع Google Cloud Console نفسه.
- تأكّد من تمرير رمز مميّز فريد للجلسة لكل جلسة جديدة. وسيؤدي استخدام الرمز المميّز نفسه لأكثر من جلسة إلى تحرير فاتورة لكل طلب على حدة.
يمكنك اختياريًا حذف الرمز المميّز للإكمال التلقائي من طلب معيّن. إذا تم حذف الرمز المميّز للجلسة، تتم فوترة كل طلب بشكل منفصل، ما يؤدي إلى تفعيل ميزة الإكمال التلقائي - لكل طلب. رمز التخزين التعريفي إذا أعدت استخدام رمز مميّز للجلسة، سيتم اعتبار الجلسة غير صالحة ويتم تحصيل الرسوم من الطلبات كما لو لم يتم تقديم رمز مميّز للجلسة.
مثال
أثناء كتابة المستخدم لطلب البحث، يُسمى طلب الإكمال التلقائي كل بضعة ضغطات مفاتيح (وليس لكل حرف)، ويتم عرض قائمة بالنتائج المحتملة. عندما يُجري المستخدم تحديدًا من قائمة النتائج، يتم احتساب الاختيار على أنه طلب، ويتم تجميع كل الطلبات المُقدَّمة أثناء البحث ويتم احتسابها كطلب واحد. إذا اختار المستخدم مكانًا، سيتوفّر طلب البحث بدون أي رسوم، ولن يتم تحصيل أي رسوم إلا مقابل طلب بيانات المكان. وإذا لم يُجرِ المستخدم خيارًا في غضون بضع دقائق من بداية الجلسة، سيتم تحصيل رسوم طلب البحث فقط.
وسنبدأ بفحص تدفق الأحداث هذا من منظور أحد التطبيقات.
- يبدأ مستخدم في كتابة طلب بحث عن "وباريس وفرنسا"
- عند اكتشاف إدخال المستخدم، ينشئ التطبيق رمزًا مميزًا جديدًا للجلسة، &"الرمز المميز A".
- أثناء كتابة المستخدم، ترسل واجهة برمجة التطبيقات طلبًا للإكمال التلقائي لكل بضعة أحرف، مع عرض قائمة جديدة من النتائج المحتملة لكل من:
"P"
"Par"
"باريس"
"باريس, Fr"
- عندما يُحدِّد المستخدم خيارًا:
- يتم تجميع كل الطلبات الناتجة عن الطلب وإضافتها إلى الجلسة التي يتم تمثيلها من خلال &"الرمز المميز A" كطلب واحد.
- يتم احتساب اختيار المستخدم كطلب تفاصيل المكان، وتتم إضافته إلى الجلسة التي يمثّلها الرمز المميّز "أ&الرمز المميّز".
- يتم إنهاء الجلسة ويتجاهل التطبيق "الرمز المميز A".
لمزيد من المعلومات حول طريقة تحصيل الرسوم من طلبات الإكمال التلقائي، يُرجى الاطّلاع على الاستخدام والفوترة.
إنشاء رموز مميزة للجلسة
يمكنك إنشاء الرموز المميّزة للجلسة باستخدام أي آلية آلية تفضّلها. نقترح استخدام الإصدار 4 من UUID للرموز المميزة للجلسة.