اختيار النظام الأساسي: Android iOS JavaScript Web Service

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

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

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

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

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

  • يتم استدعاء خدمة "تفاصيل المكان" (الجديدة).
  • يتم استدعاء Address Validation.
  • تم إيقاف الجلسة.

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

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