直接在自家平台上提供產品資訊管理的供應商，可以驗證商家的 在網站上查看資訊如此一來，您就不需要將商家重新導向至 商家檔案使用者介面。
取得目前狀態
使用者可以呼叫 locations.getVoiceOfMerchantState
即可擷取目前狀態。如果
hasVoiceOfMerchant
布林值為 true，表示該位置已記錄良好，無需採取其他動作。否則，如果回覆中的 gain_voice_of_merchant 動作包含 verify，則您必須完成驗證。詳情請參閱下方操作說明。
擷取驗證選項
供應商可以使用
locations.fetchVerificationOptions敬上
方法，提示商家從可用聯絡方式清單中選擇偏好的聯絡方式
驗證方法。
如要擷取驗證選項，請使用下列方式：
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions
{
"languageCode": "en"
}
開始驗證程序
選擇驗證方法後，請使用
locations.verify。
因此，呼叫之後，該地點會進入已驗證狀態，或傳回錯誤狀態。
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify
// Use only one of the below verification methods
// For postcard verification:
{
"method": "ADDRESS",
"languageCode": "en",
"addressInput": {
"mailerContactName": "Ann Droyd"
}
}
// For phone verification:
{
"method": "PHONE_CALL",
"languageCode": "en",
"phoneInput": {
"phoneNumber": "800-555-0136"
}
}
// For SMS verification:
{
"method": "SMS",
"languageCode": "en",
"phoneInput": {
"phoneNumber": "800-555-0136"
}
}
// For email verification:
{
"method": "EMAIL",
"languageCode": "en",
"emailInput": {
"emailAddress": "ex@google.com"
}
}
擷取目前的驗證資料
locations.verifications.list敬上
呼叫 會擷取驗證要求記錄，以及呼叫中指定位置的狀態。
如要擷取所有驗證要求，請使用下列方式：
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications
完成待處理的驗證
PIN 碼和
locations.verifications.complete敬上
方法通常需要完成商家驗證。
如要完成待處理的驗證，請按照下列步驟操作：
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete
{
"pin": "123456"
}
使用 API 驗證 Google 商家檔案的最佳做法
建立位置
透過 GBP Business Information API，您可以嵌入自家平台，提供位置建立功能。要求商家新增地點時，請務必按照下列步驟操作：
收集商家的位置資訊，例如商家名稱、地址和類別。
- 呼叫
googleLocations.search端點。 - 在 API 要求中提供位置資料，例如商家名稱、類別、地址、電話號碼和網站。
或者，您也可以按照下列步驟搜尋可能的相符位置：
- 與查詢可能相符的位置。
- 請商家選擇正確的地點。
- 如果地點回應中包含「
requestAdminRightsUrl」，請協助商家要求 Google 商家檔案中該營業地點的存取權和擁有權。 - 如果
requestAdminRightsUrl不存在，請在位置回應中使用地點 ID 建立新地點。 - 驗證新的位置。
注意：如果在初始查詢中找不到可能相符的地點，請使用空白的「地點 ID」來建立新地點。然後驗證新地點。
地點驗證
如要使用 GBP API 進行驗證，請按照下列步驟操作：
- 呼叫
accounts.locations.list方法，列出 Google 帳戶的所有地點。 - 請選取要驗證的地點。
- 呼叫
GetVoiceOfMerchantAPI 方法，確認該地點是否需要驗證。 - 如果回應傳回驗證，請呼叫
fetchVerificationOptions取得可用於驗證該位置的方法清單。 - 請再次確認
verificationOption資料包含正確的地址、電話號碼和電子郵件地址。 - 機制選取最合適的驗證選項後，請呼叫
locations.verify方法來啟動適當的驗證作業。如要確認啟動中，請呼叫locations.verifications.list. - 使用商家 PIN 碼呼叫
locations.verification.complete方法。 - 呼叫
GetVoiceOfMerchantAPI 方法。如果有HasVoiceOfMerchant = true，表示已成功驗證營業地點。
注意：如果營業地點適用 AUTO 驗證，則商家不需要執行任何驗證步驟
如要進一步瞭解 Google 商家檔案驗證程序，請參閱說明中心文章。