באמצעות ההשלמה האוטומטית של מקומות, אסימוני סשנים משמשים כדי לקבץ את השאילתות והבחירה בהשלמה אוטומטית של משתמש, בסשן נפרד למטרות חיוב. הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהוא בוחר מקום ומתבצעת קריאה לפרטי מקום. כל סשן יכול לכלול מספר שאילתות של השלמה אוטומטית, ואחר כך מקום אחד לבחירה. מפתחות ה-API המשמשים לכל בקשה בסשן צריכים להיות שייכים לאותו פרויקט ב-Google Cloud Console. לאחר סיום הסשן, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם הפרמטר sessiontoken יושמט, או אם תשתמשו שוב באותו סשן, הסשן יחויב כאילו לא צוין אסימון לסשן (כל בקשה מתבצעת בנפרד).
מומלץ לבצע את ההנחיות הבאות:
- שימוש באסימוני סשנים בכל הסשנים של ההשלמה האוטומטית.
- יש ליצור אסימון חדש לכל סשן.
- יש לוודא שמפתחות ה-API שבהם נעשה שימוש בכל הבקשות להשלמה אוטומטית של מקומות ובפרטים במהלך סשן שייכים לאותו פרויקט ב-Google Cloud Console.
- חשוב להעביר אסימון סשן ייחודי בכל סשן חדש. שימוש באותו אסימון עבור יותר מביקור אחד יוביל לכך שכל בקשה תחויב בנפרד.
לא חובה להשמיט את אסימון הסשן של ההשלמה האוטומטית מבקשה. אם לא תציינו את אסימון הסשן, כל בקשה תחויב בנפרד. פעולה זו תפעיל את המק"ט השלמה אוטומטית – לכל בקשה. אם אתם עושים שימוש חוזר באסימון בסשן, הסשן נחשב לא חוקי והבקשות מחויבות כאילו לא סופק אסימון.
דוגמה
כשהמשתמש מזין שאילתה, בקשת השלמה אוטומטית נקראת כל מספר הקשות (לא לפי תווים) ותוצג רשימה של תוצאות אפשריות. כשהמשתמש בוחר מרשימת התוצאות, הבקשה נספרת כבקשה אחת, וכל הבקשות שמבוצעות במהלך החיפוש מקובצות ונכללות בבקשה אחת. אם המשתמש בוחר מקום, שאילתת החיפוש תהיה זמינה ללא חיוב ותחויב רק בבקשת נתוני המקום. אם המשתמש לא מבצע בחירה בתוך מספר דקות מתחילת הסשן, רק שאילתת החיפוש תחויב.
בואו נבחן את זרימת האירועים הזו מנקודת המבט של האפליקציה.
- משתמש מתחיל להקליד שאילתה כדי לחפש "פריז, צרפת"
- כשהמערכת מזהה קלט של משתמש, האפליקציה יוצרת אסימון הפעלה חדש, "&אסימון A"
- תוך כדי הקלדת המשתמש, ה-API שולח בקשה להשלמה אוטומטית כל כמה תווים. הוא מציג רשימה חדשה של תוצאות פוטנציאליות לכל אחד מהרכיבים:
"P"
"Par"
"Paris,"
"Paris, Fr"
- כשהמשתמש בוחר:
- כל הבקשות המתקבלות מהשאילתה מקובצות ונוספו לסשן המיוצג על ידי בקשה "אסימון A", כבקשה אחת.
- הבחירה של המשתמש נספרת כבקשה להצגת פרטי מקום, והיא מתווספת לסשן שמיוצג על ידי &&A&&.
- הסשן יסתיים, והאפליקציה תמחק את "Token A"
למידע נוסף על אופן החיוב של בקשות להשלמה אוטומטית, אפשר לעיין במאמר שימוש וחיוב.
יצירת אסימוני הפעלה
ניתן ליצור אסימוני פעילות באמצעות המנגנון הפרוגרמטי הרצוי. מומלץ להשתמש בגרסה 4 UUID של אסימוני סשנים.