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

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

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

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

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

يتمّ استدعاء Place Details (New) (تفاصيل المكان (جديد)).
يتمّ استدعاء Address Validation.
تمّت إعادة توجيه الجلسة.

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

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