الرموز المميزة للجلسات
الرموز المميّزة للجلسات هي سلاسل (أو عناصر) ينشئها المستخدم وتتتبّع طلبات الإكمال التلقائي (الجديد) على أنّها جلسات. تستخدم خدمة "الإكمال التلقائي (جديد)" الرموز المميّزة للجلسات لتجميع مراحل طلب البحث والاختيار في عملية بحث الإكمال التلقائي التي يجريها المستخدم في جلسة منفصلة لأغراض الفوترة.
يتحمّل المستخدمون مسؤولية إنشاء الرموز المميزة للجلسة لكل جلسة. يجب أن تكون الرموز المميزة للجلسات سلاسل Base64 آمنة لعناوين URL وأسماء الملفات. يمكن للمستخدمين إنشاء رموز مميزة للجلسات بأي طريقة، ولكن تنصح Google باستخدام المعرّفات الفريدة العالمية (UUID) من الإصدار 4 للرموز المميزة للجلسات.
تبدأ الجلسة بطلب إلى واجهة برمجة التطبيقات Autocomplete (New)، وتنتهي بطلب إلى تفاصيل المكان (جديد) أو Address Validation. يمكن أن تتضمّن كل جلسة طلبات بحث متعددة من خلال ميزة "الإكمال التلقائي (الجديد)"، متبوعة بطلب واحد من خلال ميزة "تفاصيل المكان (الجديد)" أو "التحقّق من العنوان". يجب أن تنتمي مفاتيح واجهة برمجة التطبيقات المستخدَمة لكل طلب ضمن جلسة إلى مشروع Google Cloud Console نفسه.
يتم إنهاء الرموز المميزة للجلسة بالطرق التالية:
- يتم استدعاء تفاصيل المكان (جديد).
- يتم استدعاء Address Validation.
- تم التخلي عن الجلسة.
بعد انتهاء الجلسة، يصبح الرمز المميّز غير صالح، ويجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة جديدة. في حال حذف المَعلمة sessionToken أو إعادة استخدام رمز مميّز للجلسة، يتم تحصيل رسوم الجلسة الجديدة كما لو لم يتم تقديم رمز مميّز للجلسة (تتم فوترة كل طلب بشكل منفصل).
لمزيد من المعلومات حول كيفية فوترة طلبات "الإكمال التلقائي (الجديد)"، يُرجى الاطّلاع على أسعار "الإكمال التلقائي (الجديد)" والجلسات.