کدهای جلسه

«تکمیل خودکار مکان» (قدیمی) از نشان‌های جلسه برای گروه‌بندی مراحل پُرسمان و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صدور صورت‌حساب استفاده می‌کند. جلسه زمانی شروع می‌شود که کاربر شروع به تایپ کردن پُرسمان می‌کند و زمانی به‌پایان می‌رسد که کاربر مکانی را انتخاب می‌کند و تماسی با «جزئیات مکان (قدیمی)» برقرار می‌شود. هر جلسه می‌تواند چندین پُرسمان تکمیل خودکار داشته باشد که با یک انتخاب مکان دنبال می‌شود. کلید(های) API مورداستفاده برای هر درخواست در یک جلسه باید متعلق به پروژه کنسول Google Cloud یکسان باشد. پس‌از پایان جلسه، کد دیگر معتبر نیست؛ برنامه شما باید برای هر جلسه کد جدیدی تولید کند. اگر پارامتر sessiontoken حذف شود، یا اگر از رمز جلسه مجدداً استفاده کنید، هزینه جلسه به‌گونه‌ای محاسبه می‌شود که انگار رمز جلسه ارائه نشده است (هزینه هر درخواست به‌طور جداگانه محاسبه می‌شود).

رهنمودهای زیر را توصیه می‌کنیم:

• از کد جلسه برای همه جلسه‌های تکمیل خودکار استفاده کنید.
• برای هر جلسه کد جدیدی تولید کنید.
• مطمئن شوید که کلید(های) API استفاده‌شده برای همه درخواست‌های «تکمیل خودکار مکان» (قدیمی) و «جزئیات مکان» (قدیمی) در یک جلسه متعلق به یک پروژه «واحد مدیریت Google Cloud» باشد.
• حتماً برای هر جلسه جدید، کد جلسه یکتایی ارسال کنید. استفاده از یکسان برای بیش از یک جلسه منجر به صورت‌حساب جداگانه برای هر درخواست می‌شود.

می‌توانید به‌صورت اختیاری کد جلسه تکمیل خودکار را از درخواست حذف کنید. اگر رمزه جلسه حذف شود، هزینه هر درخواست به‌طور جداگانه محاسبه می‌شود و تکمیل خودکار - براساس درخواست واحد نگهداری موجودی را راه‌اندازی می‌کند. اگر از کد جلسه مجدداً استفاده کنید، جلسه نامعتبر درنظر گرفته می‌شود و درخواست‌ها طوری محاسبه می‌شود که انگار کد جلسه ارائه نشده است.

مثال

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

بیایید این جریان رویدادها را از دیدگاه یک برنامه بررسی کنیم.

1. کاربری شروع به تایپ پُرسمانی برای جستجوی «پاریس، فرانسه» می‌کند.
2. پس‌از تشخیص ورودی کاربر، برنامه یک کد جلسه جدید، «کد A»، ایجاد می‌کند.
3. هم‌زمان با تایپ کاربر، «میانای برنامه‌سازی کاربردی» هر چند نویسه یک درخواست تکمیل خودکار ارسال می‌کند و فهرست جدیدی از نتایج احتمالی برای هریک نمایش می‌دهد:
   «P»
   «Par»
   «Paris»
   «Paris, Fr»
   
4. وقتی کاربر انتخابی انجام می‌دهد:
   • همه درخواست‌های ناشی از پُرسمان گروه‌بندی می‌شوند و به‌عنوان یک درخواست واحد به جلسه نشان‌داده‌شده با «نشان A» اضافه می‌شوند.
   • انتخاب کاربر به‌عنوان درخواست «جزئیات مکان» محاسبه می‌شود و به جلسه نشان‌داده‌شده با «نشان A» اضافه می‌شود.
5. جلسه به‌پایان می‌رسد و برنامه «رمز A» را دور می‌اندازد.

برای اطلاعات بیشتر درباره نحوه صورت‌حساب درخواست‌های «تکمیل خودکار مکان» (قدیمی)، به استفاده و صورت‌حساب مراجعه کنید.

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

برای ایجاد کردن نشان جلسه، AutocompleteSessionToken.newInstance() را فراخوانی کنید.