تجمِّع رموز الجلسات مراحل طلب البحث والاختيار في بحث الإكمال التلقائي الذي يجريه المستخدم في جلسة منفصلة لأغراض الفوترة.
إنشاء رمز مميّز للجلسة
تقع على عاتق المستخدمين مسؤولية إنشاء رموز مميّزة فريدة لكل جلسة. تنصح Google باستخدام معرّفات UUID
الإصدار 4.
مثال
أثناء كتابة المستخدم لطلب بحث، يتم استدعاء طلب إكمال تلقائي بعد كل بضعة أحرف (وليس لكل حرف)، ويتم عرض قائمة بالنتائج المحتملة. عندما يختار المستخدم نتيجة من قائمة النتائج، يتم احتساب هذا الاختيار كطلب، ويتم تجميع جميع الطلبات التي تم إجراؤها أثناء البحث واحتسابها كطلب واحد. إذا اختار المستخدم مكانًا، يكون طلب البحث متاحًا بدون أي رسوم، ويتم تحصيل رسوم طلب بيانات المكان فقط. إذا لم يجرِ المستخدم أي اختيار في غضون بضع دقائق من بداية الجلسة، يتم تحصيل رسوم طلب البحث فقط.
لنلقِ نظرة على هذا التسلسل من الأحداث من منظور تطبيق.
يبدأ المستخدم في كتابة طلب بحث للبحث عن "باريس، فرنسا".
عند رصد بيانات أدخلها المستخدم، ينشئ التطبيق الرمز المميز للجلسة جديدًا، وهو "الرمز المميّز أ".
أثناء كتابة المستخدم، ترسل واجهة برمجة التطبيقات طلب إكمال تلقائي بعد كل بضعة
أحرف، وتعرض قائمة جديدة بالنتائج المحتملة لكل منها:
"P"
"Par"
"Paris,"
"Paris, Fr"
عندما يختار المستخدم:
يتم تجميع جميع الطلبات الناتجة عن طلب البحث وإضافتها إلى الجلسة الممثّلة بالرمز المميّز "أ"، وذلك كطلب واحد.
يتم احتساب اختيار المستخدم كطلب تفاصيل المكان، ويتم إضافته إلى الـ
جلسة الممثّلة بالرمز المميّز "أ".
تنتهي الجلسة، ويتجاهل التطبيق "الرمز المميّز أ".
لمزيد من المعلومات حول كيفية تحصيل رسوم طلبات الإكمال التلقائي، يُرجى الاطّلاع على مقالة الاستخدام و
الفوترة.
تاريخ التعديل الأخير: 2026-05-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2026-05-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]