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

الرموز المميزة للجلسة هي سلاسل (أو كائنات) من إنشاء المستخدمين تتتبّع استدعاءات الإكمال التلقائي (جديد) كـ جلسات. يستخدم الإكمال التلقائي (جديد) رموز الجلسة المميّزة لتجميع مرحلتَي طلب البحث والاختيار من بحث المستخدِم للإكمال التلقائي في جلسة منفصلة لأغراض الفوترة.

يتحمّل المستخدمون مسؤولية إنشاء رموز مميّزة للجلسة لكلّ جلسة. يجب أن تكون الرموز المميّزة للجلسة عبارة عن سلسلتَي base64 آمنة لكل من عنوان URL واسم ملف. يمكن للمستخدمين إنشاء الرموز المميّزة للجلسة بأي طريقة، مع أنّ Google تنصح باستخدام المعرّفات الفريدة عالميًا للإصدار 4 (UUID) للرموز المميّزة للجلسة.

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

تنتهي الرموز المميّزة للجلسة بالطرق التالية:

يُطلق على تفاصيل المكان (جديد).
ويتم استدعاء عملية التحقق من العنوان.
تم إنهاء الجلسة.

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

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