بينما يكتب المستخدم طلب بحث، يتمّ استدعاء طلب الإكمال التلقائي بعد كل بضع
ضغطات مفتاح (وليس لكلّ حرف)، ويتمّ عرض قائمة بالنتائج المحتمَلة. عندما يختار
المستخدم أحد النتائج من قائمة النتائج، يتم احتساب هذا الاختيار كأحد
الطلبات، ويتم تجميع جميع الطلبات التي تم إجراؤها أثناء عملية البحث واحتساب
هذه الطلبات كطلب واحد. إذا اختار المستخدم مكانًا، يكون طلب البحث متاحًا بدون أي رسوم، ولا يتم تحصيل رسوم إلا مقابل طلب بيانات المكان. إذا لم يصنِّف المستخدِم
النتائج خلال بضع دقائق من بدء الجلسة، يتم تحصيل رسوم عن
طلب البحث فقط.
لنطّلِع على تسلسل الأحداث هذا من منظور أحد التطبيقات.
يبدأ مستخدم بكتابة طلب بحث للبحث عن "باريس، فرنسا".
عند رصد إدخال المستخدم، ينشئ التطبيق رمزًا مميّزًا جديدًا لجلسة
، وهو "الرمز المميّز (أ)".
بينما يكتب المستخدم، تُرسل واجهة برمجة التطبيقات طلبًا للإكمال التلقائي بعد كل بضع
أحرف، وتعرض قائمة جديدة بالنتائج المحتملة لكل منها:
"P"
"Par"
"Paris,"
"Paris, Fr"
عندما يختار المستخدم أحد الخيارات:
يتم تجميع جميع الطلبات الناتجة عن طلب البحث وإضافتها إلى
الجلسة التي يمثّلها "الرمز المميّز أ"، كطلب واحد.
يتم احتساب اختيار المستخدم كطلب لتفاصيل مكان، ويتمّ إضافته
إلى الجلسة التي تمثّلها "الرمز المميّز (أ)".
تنتهي الجلسة، ويتخلّص التطبيق من "الرمز المميّز أ".
لمزيد من المعلومات حول كيفية فوترة طلبات ميزة "الإكمال التلقائي"، يُرجى الاطّلاع على الاستخدام
والفواتير.
تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Session tokens associate autocomplete search queries and selections for billing, ensuring accurate charges based on user interactions."],["Each new search session requires a unique, user-generated token, ideally a version 4 UUID, to track related requests."],["Autocomplete requests during a search are grouped and billed as a single request when the user makes a selection, charging only for Place data if a place is chosen."],["If no selection is made within a few minutes, only the search query is billed, attributing costs to the initial search activity."],["Session tokens are project-specific, allowing reuse across different Google Cloud projects but requiring uniqueness within the same project for proper billing."]]],["Session tokens group user autocomplete searches for billing. Generate unique session tokens (e.g., version 4 UUIDs) per project. As users type, autocomplete requests are made. Upon selection, all requests are bundled into a single, session-token-linked request. If a place is selected, only the Place data request is charged. Otherwise, only the search query is charged. If no selection is made, the session times out, and only the search query is billed. Discard the token after the session.\n"]]