אסימוני סשן מקובצים לשלבים של השאילתה והבחירה בחיפוש של המשתמש להשלמה אוטומטית, ויוצרים סשן נפרד למטרות חיוב.
יצירת טוקן לסשן
המשתמשים אחראים ליצור אסימוני סשן ייחודיים לכל סשן.
Google ממליצה להשתמש ב-UUIDs מגרסה 4.
דוגמה
כשהמשתמש מקלידים שאילתות, מתבצעת קריאה לבקשה להשלמה אוטומטית אחרי כל כמה הקשות (לא לכל תו) וחוזרת רשימה של תוצאות אפשריות. כשהמשתמש בוחר מתוך רשימת התוצאות, הבחירה נספרת כבקשה, וכל הבקשות שנשלחו במהלך החיפוש מקובצות ונספרות כבקשה אחת. אם המשתמש בוחר מקום, שאילתה החיפוש זמינה ללא תשלום, ורק הבקשה לנתוני המקום מחויבת. אם המשתמש לא יבצע בחירה תוך כמה דקות מתחילת הסשן, יחויב רק על שאילתה החיפוש.
נבחן את תהליך האירועים הזה מנקודת המבט של אפליקציה.
משתמש מתחיל להקליד שאילתת חיפוש עבור 'פריז, צרפת'.
כשהאפליקציה מזהה קלט של משתמש, היא יוצרת אסימון סשן חדש, 'אסימון א'.
כשהמשתמש מקלידים, ה-API שולח בקשה להשלמה אוטומטית אחרי כל כמה תווים, ומציג רשימה חדשה של תוצאות אפשריות לכל אחד מהם:
"P"
"Par"
"Paris,"
"Paris, Fr"
כשהמשתמש מבצע בחירה:
כל הבקשות שנובעות מהשאילתה מקובצות ומתווספות לסשן שמיוצג על ידי אסימון א', כבקשה אחת.
הבחירה של המשתמש נספרת כבקשה לפרטים של מקום, ומתווספת לסשן שמיוצג על ידי אסימון א'.
הסשן מסתיים והאפליקציה משליכה את אסימון א'.
מידע נוסף על החיוב על בקשות להשלמה אוטומטית זמין בקטע שימוש וחיובים.
[null,null,["עדכון אחרון: 2025-01-14 (שעון UTC)."],[[["Session tokens associate autocomplete search queries and selections for billing, ensuring accurate charges based on user interactions."],["Each new search session requires a unique, user-generated token, ideally a version 4 UUID, to track related requests."],["Autocomplete requests during a search are grouped and billed as a single request when the user makes a selection, charging only for Place data if a place is chosen."],["If no selection is made within a few minutes, only the search query is billed, attributing costs to the initial search activity."],["Session tokens are project-specific, allowing reuse across different Google Cloud projects but requiring uniqueness within the same project for proper billing."]]],[]]
