GoogleLocations

您可以使用 GoogleLocations API 事先查看某個地點是否已在商家檔案中聲明為商家所在地點。這樣一來，如果有人聲明擁有該地點，您就能立即要求存取該地點。此外，如果您管理的是經過大量驗證的帳戶，可以更準確地選取可能的配對項目，避免建立重複的位置。

API 端點會傳回網址，指出是否已聲明某個地點。如果已宣稱，您可以透過相同的網址啟動存取要求程序。

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

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

您可以按照下列步驟使用 GoogleLocations API：

  1. 向商家收集位置資料。

  2. 呼叫 googleLocations.search 端點。請在呼叫主體中提供位置資料。或者，您也可以在查詢字串中提供這項資訊，類似於使用者在 Google 搜尋或 Google 地圖中輸入的資訊。例如「Starbucks 5th ave NYC」。

    API 會傳回可能相符的位置清單，以及每個位置的相關資訊，例如 locationName 和地址。

  3. 選取符合你所在位置的地區。如果沒有相符項目，請呼叫 accounts.locations.create，然後跳至步驟 5。

  4. 根據回應中的 requestAdminRightsUrl 狀態，採取下列行動：

    1. 如果存在 requestAdminRightsUrl，表示有其他使用者擁有這項資訊。請將商家導向至這個網址，以便開始要求商家檔案中現有地點的存取權和擁有權。
    2. 如果 requestAdminRightsUrl 不存在，請呼叫 accounts.locations.create，並建立新的商家資訊，以便稍後進行驗證。
  5. 如果您在這個程序中建立了新產品資訊，可以使用驗證 API 開始驗證產品資訊。詳情請參閱「管理驗證」。