工作階段符記會將使用者自動完成搜尋的查詢和選取階段分組為個別工作階段,以便計費。
建立工作階段符記
使用者必須為每個工作階段產生專屬的工作階段權杖。Google 建議使用第 4 版 UUID。
範例
使用者輸入查詢時,系統會每隔幾個按鍵 (不是每個字元) 呼叫一次自動完成要求,並傳回可能的結果清單。當使用者從結果清單中選取項目時,系統會將該選項計為一個要求,並將搜尋期間提出的所有要求合併計算為單一要求。如果使用者選取地點,系統就會免費提供搜尋查詢,只會收取地點資料要求的費用。如果使用者在工作階段開始後的幾分鐘內未選取任何項目,系統只會收取搜尋查詢費用。
讓我們從應用程式的角度來看看這個事件流程。
- 使用者開始輸入查詢,搜尋「巴黎 (法國)」。
- 在偵測到使用者輸入內容後,應用程式會建立新的會話憑證「Token A」。
- 使用者輸入內容時,API 會每隔幾個字元發出一次自動完成要求,並為每個字元顯示新的可能結果清單:
"P"
"Par"
"Paris,"
"Paris, Fr"
- 使用者選取項目時:
- 查詢產生的所有要求會以單一要求的形式,加進由「Token A」代表的工作階段。
- 使用者的選項會計為 Places Details 要求,並新增至由「Token A」代表的工作階段。
- 工作階段結束,應用程式會捨棄「Token A」。
如要進一步瞭解 Autocomplete 要求的計費方式,請參閱「使用量和計費」。