«تکمیل خودکار مکان» (قدیمی) از نشان‌های جلسه برای گروه‌بندی مراحل پُرسمان و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صدور صورت‌حساب استفاده می‌کند. جلسه زمانی شروع می‌شود که کاربر شروع به تایپ کردن پُرسمانی می‌کند و زمانی به‌پایان می‌رسد که مکانی را انتخاب می‌کند و تماسی با «جزئیات مکان» (قدیمی) برقرار می‌شود. هر جلسه می‌تواند
چندین پُرسمان تکمیل خودکار داشته باشد که با یک انتخاب مکان دنبال می‌شود. کلید(های) API مورداستفاده برای هر درخواست در یک جلسه باید متعلق به پروژه
کنسول Google Cloud یکسان باشد. وقتی جلسه به پایان می‌رسد، کد دیگر معتبر نیست؛
برنامه شما باید برای هر جلسه کد جدیدی تولید کند. اگر پارامتر
sessiontoken حذف شود، یا اگر از رمز جلسه مجدداً استفاده کنید، هزینه جلسه به‌گونه‌ای محاسبه می‌شود که انگار رمز جلسه ارائه نشده است (هزینه هر درخواست
به‌طور جداگانه محاسبه می‌شود).
توصیه می‌کنیم از رهنمودهای زیر پیروی کنید:
- از نشان‌های جلسه برای همه جلسه‌های تکمیل خودکار استفاده کنید.
- برای هر جلسه کد جدیدی تولید کنید.
- مطمئن شوید که کلید(های) API استفاده‌شده برای همه درخواست‌های «تکمیل خودکار مکان» (قدیمی) و «جزئیات مکان» (قدیمی) در یک جلسه متعلق به یک پروژه «واحد مدیریت Google Cloud» باشد.
- حتماً برای هر جلسه جدید، یک کد جلسه یکتا ارسال کنید. استفاده از یکسان برای بیش از یک جلسه منجر به صورت‌حساب جداگانه برای هر درخواست می‌شود.
می‌توانید به‌صورت اختیاری کد جلسه تکمیل خودکار را از درخواست حذف کنید. اگر رمزه جلسه حذف شود، هزینه هر درخواست به‌طور جداگانه محاسبه می‌شود و تکمیل خودکار - براساس درخواست واحد نگهداری موجودی را راه‌اندازی می‌کند. اگر از کد جلسه مجدداً استفاده کنید، جلسه نامعتبر درنظر گرفته می‌شود و درخواست‌ها طوری محاسبه می‌شود که انگار کد جلسه ارائه نشده است.
مثال
وقتی کاربر پُرسمانی را تایپ می‌کند، درخواست تکمیل خودکار هر چند ضربه کلید (نه به‌ازای هر نویسه) فراخوانی می‌شود و فهرستی از نتایج احتمالی برگردانده می‌شود. وقتی کاربر از فهرست نتایج انتخابی انجام می‌دهد، آن انتخاب به‌عنوان یک درخواست محسوب می‌شود و همه درخواست‌های انجام‌شده درطول جستجو دسته‌بندی می‌شوند و به‌عنوان یک درخواست واحد محسوب می‌شوند. اگر کاربر مکانی را انتخاب کند، پرسمان جستجو بدون هزینه دردسترس است و فقط هزینه درخواست داده‌های «مکان» از کاربر کسر می‌شود. اگر کاربر ظرف چند دقیقه پس‌از شروع جلسه انتخابی انجام ندهد، فقط هزینه پُرسمان جستجو از او کسر می‌شود.
بیایید این جریان رویدادها را از دیدگاه یک برنامه بررسی کنیم.
- کاربری شروع به تایپ پُرسمانی برای جستجوی «پاریس، فرانسه» می‌کند.
- پس‌از تشخیص ورودی کاربر، برنامه یک کد جلسه جدید، «کد A»، ایجاد می‌کند.
- همان‌طور که کاربر تایپ می‌کند، میانای برنامه‌سازی کاربردی هر چند نویسه یک‌بار درخواست تکمیل خودکار می‌کند و فهرست جدیدی از نتایج احتمالی را برای هرکدام نمایش می‌دهد:
«P»
«Par»
«Paris,»
«Paris, Fr»
- وقتی کاربر انتخابی انجام می‌دهد:
- همه درخواست‌های ناشی از پُرسمان گروه‌بندی می‌شوند و به‌عنوان یک درخواست واحد به جلسه نشان‌داده‌شده با «نشان A» اضافه می‌شوند.
- انتخاب کاربر به‌عنوان درخواست «جزئیات مکان» محاسبه می‌شود و به جلسه نشان‌داده‌شده با «نشان A» اضافه می‌شود.
- جلسه به‌پایان می‌رسد و برنامه «نشان A» را دور می‌اندازد.
برای اطلاعات بیشتر درباره نحوه صورت‌حساب درخواست‌های «تکمیل خودکار مکان» (قدیمی)، به استفاده و صورت‌حساب مراجعه کنید.
ایجاد کردن کد جلسه
می‌توانید بااستفاده از هر سازوکار برنامه‌ای که ترجیح می‌دهید، کد جلسه ایجاد کنید. توصیه می‌کنیم از نسخه ۴ UUID برای کد جلسه استفاده کنید.