אסימוני סשנים הם מחרוזות (או אובייקטים) שנוצרים על ידי משתמשים ומשמשים למעקב אחרי קריאות ל-Autocomplete (חדש) בתור סשנים. ב'השלמה אוטומטית' (חדש) נעשה שימוש באסימוני סשן כדי לקבץ את שלבי השאילתה והבחירה בחיפוש של משתמש עם השלמה אוטומטית לסשן נפרד למטרות חיוב.
המשתמשים אחראים ליצור אסימוני סשן לכל סשן. אסימוני הסשן חייבים להיות מחרוזות Base64 ללא סימנים אסורים בכתובות URL ובשמות קבצים. משתמשים יכולים ליצור אסימוני סשן בכל דרך, אבל Google ממליצה להשתמש במזהי UUID (מזהי ייחודיים אוניברסליים) בגרסה 4 לאסימוני סשן.
הסשן מתחיל בקריאה להשלמה האוטומטית (חדשה) ומסתיים בקריאה לפרטי המקום (חדשים) או לאימות הכתובת. כל סשן יכול לכלול מספר שאילתות של השלמה אוטומטית (חדש), ולאחר מכן בקשה אחת ל'פרטי מקום' (חדש) או לאימות כתובת. מפתחות ה-API שמשויכים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud.
אסימוני סשן מסתיימים בדרכים הבאות:
המערכת קוראת לפונקציה Place Details (New).
מתבצעת קריאה ל-Address Validation.
הסשן יבוטל.
בסיום הסשן, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן חדש. אם מפספסים את הפרמטר sessionToken או משתמשים שוב באסימון סשן, הסשן החדש יחויב כאילו לא סופק אסימון סשן (כל בקשה מחויבת בנפרד).
[null,null,["עדכון אחרון: 2025-01-14 (שעון UTC)."],[[["Session tokens track Autocomplete (New) calls as sessions for billing purposes, grouping query and selection phases."],["Users must create URL- and filename-safe base64 strings as session tokens for each session, ideally using version 4 UUIDs."],["A session starts with an Autocomplete (New) call and ends with a Place Details (New) or Address Validation call, allowing multiple Autocomplete queries within the session."],["Session tokens expire after a Place Details (New) or Address Validation call, if abandoned, or if reused; a new token is needed for each session."],["Omitting or reusing session tokens results in each request being billed separately, instead of as a session."]]],[]]
