טוקנים לסשנים

טוקנים לסשנים הם מחרוזות (או אובייקטים) שנוצרים על ידי המשתמשים, ועוקבים אחרי קריאות ל-Autocomplete (חדש) בתור סשנים. השלמה אוטומטית (חדשה) משתמשת בטוקנים לסשנים כדי לקבץ את שלבי השאילתה והבחירה של חיפוש עם השלמה אוטומטית של משתמש לסשן נפרד לצורכי חיוב.

המשתמשים אחראים ליצור טוקנים לכל סשן. הטוקנים לסשן חייבים להיות מחרוזות Base64 בטוחות לכתובות URL ולשמות קבצים. המשתמשים יכולים ליצור טוקנים לסשנים בכל דרך, אבל Google ממליצה להשתמש במזהים ייחודיים אוניברסליים (UUID) בגרסה 4 בשביל טוקנים לסשנים.

הסשן מתחיל בקריאה ל-Autocomplete (חדש) ומסתיים בקריאה ל-Place Details (חדש) או ל-Address Validation. כל סשן יכול לכלול כמה שאילתות של השלמה אוטומטית (חדש), ואחריהן בקשה אחת ל-Place Details (חדש) או ל-Address Validation. מפתחות ה-API שמשמשים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud.

התוקף של טוקנים לסשנים מסתיים במקרים הבאים:

• מתבצעת קריאה ל-Place Details (New).
• מתבצעת קריאה ל-Address Validation.
• הסשן ננטש.

אחרי שהסשן מסתיים, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן חדש. אם הפרמטר sessionToken לא מצוין, או אם משתמשים שוב בטוקן לסשן, הסשן החדש מחויב כאילו לא סופק טוקן לסשן (כל בקשה מחויבת בנפרד).

למידע נוסף על החיוב של בקשות השלמה אוטומטית (חדש), ראו השלמה אוטומטית (חדש) ותמחור סשנים.