אסימוני סשן
אסימוני סשנים הם מחרוזות (או אובייקטים) שנוצרים על ידי משתמשים ומשמשים למעקב אחרי קריאות ל-Autocomplete (חדש) בתור סשנים. ב'השלמה אוטומטית (חדש)' נעשה שימוש באסימוני סשן כדי לקבץ את שלבי השאילתה והבחירה בחיפוש של משתמש עם השלמה אוטומטית לסשן נפרד למטרות חיוב.
המשתמשים אחראים ליצור אסימוני סשן לכל סשן. אסימוני הסשן חייבים להיות מחרוזות Base64 ללא תווים לא חוקיים בכתובות URL ובשמות קבצים. משתמשים יכולים ליצור אסימוני סשן בכל דרך, אבל Google ממליצה להשתמש במזהים ייחודיים אוניברסליים (UUID) בגרסה 4 לאסימוני סשן.
הסשן מתחיל בקריאה להשלמה אוטומטית (חדשה) ומסתיים בקריאה לפרטי המקום (חדשים) או לאימות כתובת. כל סשן יכול לכלול מספר שאילתות של השלמה אוטומטית (חדש), ולאחר מכן בקשה אחת ל'פרטי מקום' (חדש) או לאימות כתובת. מפתחות ה-API שמשמשים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud.
אסימוני סשן מסתיימים בדרכים הבאות:
- המערכת קוראת לפונקציה Place Details (New).
- מתבצעת קריאה ל-Address Validation.
- הסשן יבוטל.
בסיום הסשן, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן חדש. אם הפרמטר sessionToken לא יצוין או אם תשתמשו שוב באסימון הסשן, הסשן החדש יחויב כאילו לא סופק אסימון סשן (כל בקשה מחויבת בנפרד).
מידע נוסף על החיוב על בקשות של Autocomplete (חדש) זמין במאמר תמחור של Autocomplete (חדש) וסשנים.