אסימוני סשן הם מחרוזות (או אובייקטים) שנוצרים על ידי המשתמשים ועוקבים אחרי קריאות של השלמה אוטומטית (חדש) כסשנים. ההשלמה האוטומטית (חדש) משתמשת בטוקנים של סשנים כדי לקבץ את שלבי השאילתה והבחירה של חיפוש השלמה אוטומטית של משתמש לסשן נפרד למטרות חיוב.
המשתמשים אחראים ליצירת טוקנים של סשנים לכל סשן. אסימוני סשן
חייבים להיות מחרוזות Base64 בטוחות לשימוש בכתובות URL ובשמות קבצים. המשתמשים יכולים ליצור אסימוני סשן בכל דרך, אבל Google ממליצה להשתמש במזהים ייחודיים אוניברסליים (UUID) בגרסה 4 לאסימוני סשן.
הסשן מתחיל בקריאה ל-Autocomplete (New) ומסתיים בקריאה ל-Place Details (New) או ל-Address Validation. בכל סשן יכולות להיות כמה שאילתות של השלמה אוטומטית (חדשה), ואחריהן בקשה אחת של פרטי מקום (חדש) או אימות כתובת. מפתחות ה-API שמשמשים לכל בקשה בסשן צריכים להיות שייכים לאותו פרויקט במסוף Google Cloud.
אסימוני סשן מסתיימים בדרכים הבאות:
מתבצעת קריאה ל-Place Details (New).
הפונקציה Address Validation נקראת.
הסשן ננטש.
אחרי שסיימתם את הפעילות, האסימון לא תקף יותר. האפליקציה צריכה ליצור אסימון חדש לכל פעילות חדשה. אם הפרמטר sessionToken מושמט, או אם משתמשים מחדש בטוקן סשן, הסשן החדש יחויב כאילו לא סופק טוקן סשן (כל בקשה מחויבת בנפרד).
[null,null,["עדכון אחרון: 2025-07-15 (שעון 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."]]],["To use this feature, enable Places API (New). Session tokens, which are URL-safe base64 strings (ideally UUIDs), group autocomplete queries and selections into sessions for billing. A session begins with an Autocomplete (New) call and ends with a Place Details (New) or Address Validation call. Each session can contain several autocomplete queries. Tokens are single-use per session; reusing them or omitting them results in per-request billing.\n"]]
