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