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