工作階段符記

工作階段符記是由使用者產生的字串,會將 Autocomplete (New) 呼叫視為工作階段來追蹤。Autocomplete (新版) 會使用工作階段符記,將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段,以用於計費。

使用者應負責建立每個工作階段的工作階段符記。工作階段符記必須是網址和檔案名稱安全 base64 字串。使用者能夠以任何方式產生工作階段符記,但 Google 建議針對工作階段符記使用第 4 版通用唯一識別碼 (UUID)

工作階段從呼叫 Autocomplete (New) 開始,然後呼叫 Place Details (New)Address Validation。每個工作階段可以有多個 Autocomplete (新) 查詢,後面接著一個 Place Details (新版) 或地址驗證要求。工作階段內用於每個要求的 API 金鑰必須屬於同一個 Google Cloud 控制台專案。

工作階段符記終止的方式如下:

  • 會呼叫 Place Details (新版)。
  • 系統會呼叫 Address Validation。
  • 系統已捨棄工作階段。
工作階段結束後,符記就會失效;應用程式必須為每個新的工作階段產生新的符記。如果省略 sessionToken 參數或重複使用工作階段符記,系統會視為未提供工作階段符記,並針對新工作階段收費 (每個要求分別收費)。如要進一步瞭解 Autocomplete (新) 要求的計費方式,請參閱「Autocomplete (新版) 和工作階段定價」。