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

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

ننصحك باتّباع الإرشادات التالية:

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

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

مثال

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

لنفترض أنّ تسلسل الأحداث من منظور التطبيق هو كالتالي:

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

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

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

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