رموز الجلسات هي سلاسل (أو عناصر) ينشئها المستخدمون وتتتبّع طلبات الإكمال التلقائي (جديد) باعتبارها جلسات. تستخدم ميزة "الإكمال التلقائي" (جديدة) رموز الجلسات لتجميع مراحل طلب البحث والاختيار في عملية بحث الإكمال التلقائي التي يجريها المستخدم في جلسة منفصلة لأغراض الفوترة.
يتحمّل المستخدمون مسؤولية إنشاء رموز مميّزة للجلسات لكل جلسة. يجب أن تكون رموز الجلسة سلاسل base64 آمنة للاستخدام في عناوين URL وأسماء الملفات. يمكن للمستخدمين إنشاء رموز مميّزة للجلسات بأي طريقة، ولكن تنصح Google باستخدام المعرّفات الفريدة الشاملة (UUID) الإصدار 4 لرموز الجلسات.
تبدأ الجلسة بطلب إلى خدمة "الإكمال التلقائي (جديد)"، وتنتهي بطلب إلى خدمة تفاصيل المكان (جديد) أو التحقّق من صحة العنوان. يمكن أن تتضمّن كل جلسة طلبات بحث متعددة من Autocomplete (New)، يليها طلب واحد إلى Place Details (New) أو Address Validation. يجب أن تكون مفاتيح واجهة برمجة التطبيقات المستخدَمة في كل طلب ضمن جلسة واحدة تابعة للمشروع نفسه على Google Cloud Console.
وبعد انتهاء الجلسة، لن يعود الرمز المميّز صالحًا، ويجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة جديدة. في حال حذف المَعلمة sessionToken أو إعادة استخدام رمز مميّز للجلسة، سيتم تحصيل رسوم الجلسة الجديدة كما لو لم يتم تقديم رمز مميّز للجلسة (سيتم تحصيل رسوم كل طلب على حدة).
تاريخ التعديل الأخير: 2025-07-15 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-15 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Session tokens track Autocomplete (New) calls as sessions for billing purposes, grouping query and selection phases."],["Users must create URL- and filename-safe base64 strings as session tokens for each session, ideally using version 4 UUIDs."],["A session starts with an Autocomplete (New) call and ends with a Place Details (New) or Address Validation call, allowing multiple Autocomplete queries within the session."],["Session tokens expire after a Place Details (New) or Address Validation call, if abandoned, or if reused; a new token is needed for each session."],["Omitting or reusing session tokens results in each request being billed separately, instead of as a session."]]],["To use this feature, enable Places API (New). Session tokens, which are URL-safe base64 strings (ideally UUIDs), group autocomplete queries and selections into sessions for billing. A session begins with an Autocomplete (New) call and ends with a Place Details (New) or Address Validation call. Each session can contain several autocomplete queries. Tokens are single-use per session; reusing them or omitting them results in per-request billing.\n"]]
