GoogleLocations

GoogleLocations API 可讓您預先查看商家檔案是否已聲明地點擁有權。這樣一來,如果位置已聲明擁有權,您可以立即要求存取位置資訊。此外,如果您管理大量驗證的帳戶,可以更精準地選擇潛在相符項目,並避免建立重複的地點。

API 端點會傳回網址,指出地點是否已聲明擁有權。如果已聲明擁有權,您可以透過相同的網址啟動存取要求程序。

下圖概略說明取得營業地點擁有權的程序。

圖 1. 商家檔案地點擁有權的 Swalane 圖表

下列步驟可讓您使用 GoogleLocations API:

  1. 收集商家的位置資料。
  2. 呼叫 googleLocations.search 端點。在通話內文中提供位置資料。您也可以在查詢字串中提供查詢字串,類似於使用者在 Google 搜尋或 Google 地圖中輸入的內容。例如: 星巴克第 5 街店。"

    API 會傳回可能相符地點的清單,以及每個地點的相關資訊 (例如 locationName 和地址)。

  3. 選取與所在地點相符的地點。如果沒有相符項目,請呼叫 accounts.locations.create,並跳到步驟 5。
  4. 請根據回應中的 requestAdminRightsUrl 狀態,執行下列動作:

    1. 如果 requestAdminRightsUrl 存在,另一位使用者擁有該商家資訊的擁有權。引導商家前往網址,要求取得商家檔案中現有營業地點的存取權和擁有權。
    2. 如果 requestAdminRightsUrl 不存在,請呼叫 accounts.locations.create 並建立新的商家資訊,之後再進行驗證。
  5. 如果您已在這項程序中建立新的商家資訊,則可使用驗證 API 開始驗證商家資訊。詳情請參閱管理驗證作業一文。