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