رموز الجلسات هي سلاسل (أو عناصر) ينشئها المستخدمون وتتتبّع طلبات الإكمال التلقائي (جديد) باعتبارها جلسات. تستخدم ميزة "الإكمال التلقائي" (جديدة) رموز الجلسات لتجميع مراحل طلب البحث والاختيار في عملية بحث الإكمال التلقائي التي يجريها المستخدم في جلسة منفصلة لأغراض الفوترة.
يتحمّل المستخدمون مسؤولية إنشاء رموز مميّزة للجلسات لكل جلسة. يجب أن تكون رموز الجلسة سلاسل base64 آمنة للاستخدام في عناوين URL وأسماء الملفات. يمكن للمستخدمين إنشاء رموز مميّزة للجلسات بأي طريقة، ولكن تنصح Google باستخدام المعرّفات الفريدة عالميًا من الإصدار 4 (UUID) لرموز الجلسات المميّزة.
تبدأ الجلسة بطلب إلى خدمة "الإكمال التلقائي (جديد)"، وتنتهي بطلب إلى خدمة تفاصيل المكان (جديد) أو التحقّق من صحة العنوان. يمكن أن تتضمّن كل جلسة طلبات بحث متعددة من Autocomplete (New)، يليها طلب واحد إلى Place Details (New) أو Address Validation. يجب أن تكون مفاتيح واجهة برمجة التطبيقات المستخدَمة في كل طلب ضمن جلسة واحدة تابعة للمشروع نفسه على Google Cloud Console.
وبعد انتهاء الجلسة، لن يعود الرمز المميّز صالحًا، ويجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة جديدة. في حال حذف المَعلمة sessionToken أو إعادة استخدام رمز مميّز للجلسة، سيتم تحصيل رسوم الجلسة الجديدة كما لو لم يتم تقديم رمز مميّز للجلسة (سيتم تحصيل رسوم كل طلب على حدة).
تاريخ التعديل الأخير: 2025-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSession 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.\u003c/p\u003e\n"],["\u003cp\u003eSession tokens must be URL- and filename-safe base64 strings, with Google recommending the use of version 4 universally unique identifiers (UUIDs).\u003c/p\u003e\n"],["\u003cp\u003eA session begins with an Autocomplete (New) call, allowing for multiple queries within the session before concluding with Place Details (New) or Address Validation.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eOmitting or reusing session tokens results in individual request billing, while fresh tokens are required for each new session to leverage session-based pricing.\u003c/p\u003e\n"]]],["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"],null,[]]
