GoogleLocations API 可讓您預先查看商家檔案是否已聲明地點擁有權。這樣一來,如果位置已聲明擁有權,您可以立即要求存取位置資訊。此外,如果您管理大量驗證的帳戶,可以更精準地選擇潛在相符項目,並避免建立重複的地點。
API 端點會傳回網址,指出地點是否已聲明擁有權。如果已聲明擁有權,您可以透過相同的網址啟動存取要求程序。
下圖概略說明取得營業地點擁有權的程序。
![](https://developers.google.cn/static/my-business/images/locations1.png?authuser=6&hl=zh-tw)
下列步驟可讓您使用 GoogleLocations
API:
- 收集商家的位置資料。
-
呼叫
googleLocations.search
端點。在通話內文中提供位置資料。您也可以在查詢字串中提供查詢字串,類似於使用者在 Google 搜尋或 Google 地圖中輸入的內容。例如: 星巴克第 5 街店。"API 會傳回可能相符地點的清單,以及每個地點的相關資訊 (例如
locationName
和地址)。 - 選取與所在地點相符的地點。如果沒有相符項目,請呼叫
accounts.locations.create
,並跳到步驟 5。 -
請根據回應中的
requestAdminRightsUrl
狀態,執行下列動作:- 如果
requestAdminRightsUrl
存在,另一位使用者擁有該商家資訊的擁有權。引導商家前往網址,要求取得商家檔案中現有營業地點的存取權和擁有權。 - 如果
requestAdminRightsUrl
不存在,請呼叫accounts.locations.create
並建立新的商家資訊,之後再進行驗證。
- 如果
- 如果您已在這項程序中建立新的商家資訊,則可使用驗證 API 開始驗證商家資訊。詳情請參閱管理驗證作業一文。