使用工作階段符記

選取平台： Android iOS 網路服務

工作階段符記會將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段，以用於計費。

建立工作階段權杖

使用者必須為每個工作階段產生專屬工作階段權杖。Google 建議使用第 4 版 UUID。

範例

使用者輸入查詢時，系統每隔幾次按鍵 (而非每個字元) 就會呼叫自動完成要求，並傳回可能的結果清單。使用者從結果清單中選取項目時，該選取項目會計為一項要求，而搜尋期間的所有要求會一併計為一項要求。如果使用者選取地點，系統不會對搜尋查詢收費，只會對地點資料要求收費。如果使用者在工作階段開始後幾分鐘內未選取任何項目，系統只會收取搜尋查詢費用。

現在就從應用程式的角度來檢視這個事件流程。

  1. 使用者開始輸入查詢，搜尋「法國巴黎」。
  2. 偵測到使用者輸入內容後，應用程式會建立新的工作階段符記「權杖 A」。
  3. 使用者輸入時，API 會每隔幾個字元發出自動完成要求，並為每個字元顯示新的可能結果清單：
    「P」
    「Par」
    「Paris」
    「Paris, Fr」
  4. 使用者選取項目時：
  • 查詢產生的所有要求都會分組，並以單一要求的形式，新增至以「權杖 A」代表的會期。
  • 系統會將使用者的選取項目計為「地點詳細資料」要求，並加入以「符記 A」表示的工作階段。
  • 工作階段結束，應用程式會捨棄「權杖 A」。

如要進一步瞭解自動完成要求的計費方式，請參閱「用量與計費」一文。