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 開始驗證商家資訊。詳情請參閱管理驗證作業一文。

注意：GoogleLocations API 旨在找出貴公司與商家之間的營業狀態。將端點用於產生待開發客戶或進行競爭分析時違反 Google 政策，並導致撤銷 API 存取權。