استفاده از نشانه های جلسه

نشانه‌های جلسه، مراحل پرس و جو و انتخاب یک جستجوی تکمیل خودکار کاربر را در یک جلسه مجزا برای اهداف صورت‌حساب گروه‌بندی می‌کنند.

یک نشانه جلسه ایجاد کنید

کاربران مسئول تولید نشانه های جلسه منحصر به فرد برای هر جلسه هستند. گوگل استفاده از UUID های نسخه 4 را توصیه می کند.

مثال

همانطور که کاربر یک پرس و جو را تایپ می کند، هر چند ضربه کلید (نه به ازای هر کاراکتر) یک درخواست تکمیل خودکار فراخوانی می شود و لیستی از نتایج ممکن برگردانده می شود. هنگامی که کاربر انتخابی را از لیست نتایج انجام می دهد، انتخاب به عنوان یک درخواست حساب می شود و همه درخواست های انجام شده در طول جستجو به صورت دسته بندی شده و به عنوان یک درخواست شمارش می شوند. اگر کاربر مکانی را انتخاب کند، درخواست جستجو بدون هزینه در دسترس است و فقط درخواست داده مکان هزینه می شود. اگر کاربر ظرف چند دقیقه پس از شروع جلسه انتخابی انجام ندهد، فقط درخواست جستجو شارژ می شود.

بیایید این جریان رویدادها را از منظر یک اپلیکیشن بررسی کنیم.

1. کاربر شروع به تایپ یک پرس و جو برای جستجوی "پاریس، فرانسه" می کند.
2. پس از شناسایی ورودی کاربر، برنامه یک نشانه جلسه جدید، "Token A" ایجاد می کند.
3. همانطور که کاربر تایپ می کند، API هر چند کاراکتر یک درخواست تکمیل خودکار می کند و لیست جدیدی از نتایج بالقوه را برای هر یک نمایش می دهد:
   "پ"
   "پار"
   "پاریس"
   "پاریس، فر"
   
4. هنگامی که کاربر انتخاب می کند:
• تمام درخواست های حاصل از پرس و جو گروه بندی می شوند و به عنوان یک درخواست به جلسه ارائه شده توسط "Token A" اضافه می شوند.
• انتخاب کاربر به عنوان یک درخواست جزئیات مکان شمارش می شود و به جلسه ای که با "Token A" نشان داده می شود اضافه می شود.
5. جلسه به پایان می رسد و برنامه "Token A" را کنار می گذارد.

برای اطلاعات بیشتر درباره نحوه صدور صورت‌حساب درخواست‌های تکمیل خودکار، استفاده و صورت‌حساب را ببینید.