کدهای جلسه رشتهها (یا اشیایی) هستند که توسط کاربر تولید میشوند و تماسهای تکمیل خودکار (جدید) را بهعنوان جلسه ردیابی میکنند. Autocomplete (New) از کد جلسه برای گروهبندی پُرسمان
و مراحل انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای
اهداف صورتحساب استفاده میکند.
کاربران مسئول ایجاد کد جلسه برای هر جلسه هستند. کدهای جلسه باید رشتههای base64 ایمن ازنظر نشانی وب و نام فایل باشند. کاربران میتوانند کد جلسه را به هر روشی تولید کنند، اما Google توصیه میکند از شناسههای یکتای جهانی (UUID) نسخه ۴ برای کدهای جلسه استفاده کنید.
جلسه با فراخوانی «تکمیل خودکار (جدید)» شروع میشود و با فراخوانی
جزئیات مکان (جدید) یا اعتبارسنجی نشانی به پایان میرسد. هر جلسه میتواند چندین پُر کردن خودکار (جدید) داشته باشد که بهدنبال آن یک درخواست برای جزئیات جا (جدید) یا اعتبارسنجی نشانی ارسال میشود. کلید(های) میانای برنامهسازی کاربردی استفادهشده برای هر درخواست در یک
جلسه باید به همان پروژه Google Cloud Console تعلق داشته باشد.
کدهای جلسه به روشهای زیر منقضی میشوند:
«جزئیات مکان (جدید)» فراخوانده میشود.
«اعتبارسنجی نشانی» فراخوانده میشود.
جلسه رها شده است.
پساز پایان جلسه، توکن دیگر معتبر نیست؛ برنامهتان باید برای هر جلسه جدید توکن جدیدی تولید کند. اگر پارامتر sessionToken حذف شود یا اگر از کد جلسه مجدداً استفاده کنید، هزینه جلسه جدید بهگونهای محاسبه میشود که گویی هیچ کد جلسهای ارائه نشده است (هر درخواست بهطور جداگانه صورتحساب میشود).
تاریخ آخرین بهروزرسانی 2026-11-10 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-11-10 بهوقت ساعت هماهنگ جهانی."],[],["Session tokens, user-generated strings, track Autocomplete (New) calls as sessions for billing. Users create tokens, ideally UUIDs, for each session. A session starts with Autocomplete (New) and ends with Place Details (New) or Address Validation, allowing multiple Autocomplete queries. The API keys must be from the same project. Omitting the token or reusing it results in per-request billing. Session tokens are invalid after use and can not be exchanged between places API and places API (new) or Address Validation.\n"]]