בחירת פלטפורמה: Android iOS JavaScript Web Service

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

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

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

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

הערה: אי אפשר להחליף טוקנים של סשנים בין נקודות קצה (endpoint) של Places API (גרסה קודמת) לבין נקודות קצה של Places API (גרסה חדשה) או Address Validation API. לדוגמה, אחרי בקשה ל-Place Autocomplete (Legacy) אפשר לשלוח בקשה ל-Place Details (Legacy) באותה סשן, אבל אי אפשר לשלוח בקשה ל-Place Details (New) או בקשה לאימות כתובת באותה סשן.

אסימוני סשן מסתיימים בדרכים הבאות:

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

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

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

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