علامات الجلسات هي سلاسل (أو عناصر) ينشئها المستخدمون وتتتبّع طلبات الإكمال التلقائي (جديد)
كجلسات. تستخدِم ميزة "الإكمال التلقائي (جديد)" الرموز المميّزة للجلسات لتجميع مراحل الطلب
والاختيار في عملية بحث الإكمال التلقائي للمستخدِم في جلسة منفصلة لأغراض
الفوترة.
يتحمّل المستخدمون مسؤولية إنشاء الرموز المميّزة للجلسة لكل جلسة. يجب أن تكون علامات
الجلسة سلاسل base64 آمنة لعناوين URL وأسماء الملفات. يمكن للمستخدمين إنشاء رموًز ميزات
الجلسات بأي طريقة، على الرغم من أنّ Google تنصح باستخدام الإصدار 4 من المعرّفات
الفريدة على مستوى العالم (UUID) لإنشاء رموز ميزات الجلسات.
تبدأ الجلسة بمكالمة إلى ميزة "الإكمال التلقائي" (جديد)، وتنتهي بمكالمة
إلى تفاصيل المكان (جديد) أو إثبات صحة العنوان. يمكن أن تحتوي كل جلسة على
طلبات بحث متعددة من خلال ميزة "الإكمال التلقائي" (جديد)، متبوعة بطلب واحد من أجل "تفاصيل المكان"
(جديد) أو "التحقّق من العنوان". يجب أن تكون مفاتيح واجهة برمجة التطبيقات المستخدَمة لكل طلب ضمن
جلسة تابعة للمشروع نفسه على Google Cloud Console.
يتمّ استدعاء Place Details (New) (تفاصيل المكان (جديد)).
يتمّ استدعاء Address Validation.
تمّت إعادة توجيه الجلسة.
بعد انتهاء الجلسة، لن يعود الرمز المميّز صالحًا، ويجب أن يُنشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة جديدة. في حال حذف مَعلمة sessionToken
أو إعادة استخدام رمز تعريف جلسة، يتم تحصيل رسوم الجلسة الجديدة كما لو لم يتم تقديم رمز تعريف جلسة (يتم تحصيل رسوم كل طلب بشكل منفصل).
تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Session tokens group Autocomplete (New) queries and selection phases into a session for billing purposes, ending with a call to Place Details (New) or Address Validation."],["Session tokens must be URL- and filename-safe base64 strings, with Google recommending the use of version 4 universally unique identifiers (UUIDs)."],["A session begins with an Autocomplete (New) call, allowing for multiple queries within the session before concluding with Place Details (New) or Address Validation."],["Each request within a session must utilize API keys associated with the same Google Cloud Console project, with sessions terminating upon calling Place Details (New), Address Validation, or abandonment."],["Omitting or reusing session tokens results in individual request billing, while fresh tokens are required for each new session to leverage session-based pricing."]]],["Session tokens, user-generated strings, track Autocomplete (New) calls as sessions for billing. Users create tokens, ideally UUIDs, for each session. A session starts with Autocomplete (New) and ends with Place Details (New) or Address Validation, allowing multiple Autocomplete queries. The API keys must be from the same project. Omitting the token or reusing it results in per-request billing. Session tokens are invalid after use and can not be exchanged between places API and places API (new) or Address Validation.\n"]]
