تجمع الرموز المميّزة للجلسات مرحلتي الطلب والاختيار في عملية بحث إكمال تلقائي
للمستخدم في جلسة منفصلة لأغراض الفوترة.
إنشاء رمز مميّز للجلسة
يتحمّل المستخدمون مسؤولية إنشاء علامات جلسة
فريدة لكل جلسة. تنصح Google باستخدام الإصدار 4 من معرّفات UUID.
مثال
بينما يكتب المستخدم طلب بحث، يتمّ استدعاء طلب الإكمال التلقائي بعد كل بضع
ضغطات مفتاح (وليس لكلّ حرف)، ويتمّ عرض قائمة بالنتائج المحتمَلة. عندما يختار
المستخدم أحد النتائج من قائمة النتائج، يتم احتساب هذا الاختيار كأحد
الطلبات، ويتم تجميع جميع الطلبات التي تم إجراؤها أثناء عملية البحث واحتساب
هذه الطلبات كطلب واحد. إذا اختار المستخدم مكانًا، يكون طلب البحث متاحًا بدون أي رسوم، ولا يتم تحصيل رسوم إلا مقابل طلب بيانات المكان. إذا لم يصنِّف المستخدِم
النتائج خلال بضع دقائق من بدء الجلسة، يتم تحصيل رسوم عن
طلب البحث فقط.
لنطّلِع على تسلسل الأحداث هذا من منظور أحد التطبيقات.
يبدأ مستخدم بكتابة طلب بحث للبحث عن "باريس، فرنسا".
عند رصد إدخال المستخدم، ينشئ التطبيق رمزًا مميزًا جديدًا للجلسة، وهو "الرمز المميّز أ".
أثناء كتابة المستخدم، تُرسل واجهة برمجة التطبيقات طلب إكمال تلقائي بعد كل بضع
أحرف، وتعرض قائمة جديدة بالنتائج المحتملة لكل منها:
"P"
"Par"
"Paris,"
"Paris, Fr"
عندما يختار المستخدم أحد الخيارات:
يتم تجميع جميع الطلبات الناتجة عن طلب البحث وإضافتها إلى الجلسة التي يمثّلها "الرمز المميّز أ"، كطلب واحد.
يتم احتساب اختيار المستخدم كطلب لتفاصيل مكان، ويتم إضافته إلى
الجلسة التي يمثّلها "الرمز المميّز (أ)".
تنتهي الجلسة، ويتخلّص التطبيق من "الرمز المميّز أ".
لمزيد من المعلومات حول كيفية فوترة طلبات ميزة "الإكمال التلقائي"، يُرجى الاطّلاع على الاستخدام
والفواتير.
تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Session tokens are used to group autocomplete search queries and selections for billing purposes."],["Each session requires a unique token, ideally a version 4 UUID."],["Autocomplete requests are bundled and billed as a single request when a user makes a selection."],["If no selection is made, only the search query is charged after a few minutes."],["Session tokens can be shared across different Google Cloud projects, but must be unique within a single project."]]],["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"]]
