نشانههای جلسه رشتهها (یا اشیاء) تولید شده توسط کاربر هستند که تماسهای تکمیل خودکار (جدید) را بهعنوان جلسه پیگیری میکنند. تکمیل خودکار (جدید) از نشانههای جلسه برای گروهبندی مراحل جستجو و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورتحساب استفاده میکند.
کاربران مسئول ایجاد نشانه های جلسه برای هر جلسه هستند. نشانههای جلسه باید رشتههای base64 ایمن URL و نام فایل باشند. کاربران میتوانند نشانههای جلسه را به هر شکلی تولید کنند، اگرچه Google توصیه میکند از نسخه 4 شناسههای منحصربهفرد جهانی (UUID) برای نشانههای جلسه استفاده کنید.
جلسه با تماس با تکمیل خودکار (جدید) شروع میشود و با تماس با جزئیات مکان (جدید) یا اعتبارسنجی آدرس به پایان میرسد. هر جلسه میتواند چندین درخواست تکمیل خودکار (جدید) داشته باشد و به دنبال آن یک درخواست برای جزئیات مکان (جدید) یا اعتبارسنجی آدرس ارائه شود. کلید(های) API مورد استفاده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد.
نشانههای جلسه به روشهای زیر خاتمه مییابند:
جزئیات مکان (جدید) نامیده می شود.
Address Validation نامیده می شود.
جلسه رها شده است.
پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه جدید یک توکن جدید تولید کند. اگر پارامتر sessionToken حذف شود، یا اگر از یک نشانه جلسه استفاده مجدد کنید، جلسه جدید به گونهای محاسبه میشود که گویی هیچ علامت جلسه ارائه نشده است (هر درخواست جداگانه صورتحساب میشود).
تاریخ آخرین بهروزرسانی 2025-03-01 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-03-01 بهوقت ساعت هماهنگ جهانی."],[[["Session tokens group Autocomplete (New) queries and selection phases into a session for billing purposes, ending with a call to Place Details (New) or Address Validation."],["Session tokens must be URL- and filename-safe base64 strings, with Google recommending the use of version 4 universally unique identifiers (UUIDs)."],["A session begins with an Autocomplete (New) call, allowing for multiple queries within the session before concluding with Place Details (New) or Address Validation."],["Each request within a session must utilize API keys associated with the same Google Cloud Console project, with sessions terminating upon calling Place Details (New), Address Validation, or abandonment."],["Omitting or reusing session tokens results in individual request billing, while fresh tokens are required for each new session to leverage session-based pricing."]]],["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"]]