Method: locations.getVoiceOfMerchantState

取得 VoiceOfMerchant 狀態。

HTTP 要求

GET https://mybusinessverifications.googleapis.com/v1/{name=locations/*}/VoiceOfMerchantState

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。位置的資源名稱。

要求主體

要求主體必須為空白。

回應主體

VoiceOfMerchant.GetVoiceOfMerchantState 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "hasVoiceOfMerchant": boolean,
  "hasBusinessAuthority": boolean,

  // Union field gain_voice_of_merchant_action can be only one of the following:
  "waitForVoiceOfMerchant": {
    object (WaitForVoiceOfMerchant)
  },
  "verify": {
    object (Verify)
  },
  "resolveOwnershipConflict": {
    object (ResolveOwnershipConflict)
  },
  "complyWithGuidelines": {
    object (ComplyWithGuidelines)
  }
  // End of list of possible types for union field gain_voice_of_merchant_action.
}
欄位
hasVoiceOfMerchant

boolean

說明地點是否仍保持良好狀態，且在 Google 上擁有商家控制權。經過審查後，你對地點所做的任何修改都會反映在 Google 地圖上。
hasBusinessAuthority

boolean

說明該地點是否在 Google 上具備商家擁有權。如果為 true，其他位置無法接管並成為 Google 地圖的主要商家資訊。不過，只有在取得商家 Voice (即 hasVoiceOfMerchant 為 true) 時，編輯內容才會上線。
聯集欄位 gain_voice_of_merchant_action。建議對該地點採取行動，以便在 Google 上取得商家控制權。gain_voice_of_merchant_action 只能是下列其中一項：
waitForVoiceOfMerchant

object (WaitForVoiceOfMerchant)

等待取得商家 Voice。為提升服務品質，我們正在審核該地點。
verify

object (Verify)

開始或繼續驗證程序。
resolveOwnershipConflict

object (ResolveOwnershipConflict)

這個地點與另一個信譽良好的地點重複。如果您可以存取位置記錄良好，請使用該位置的 ID 來執行作業。否則，請向目前的擁有者要求存取權。
complyWithGuidelines

object (ComplyWithGuidelines)

該地點不符合我們的規範，必須採取額外步驟才能恢復顯示。如要修正這個問題，請參閱說明中心文章。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/business.manage

詳情請參閱 OAuth 2.0 總覽。

WaitForVoiceOfMerchant

這個類型沒有任何欄位。

表示營業地點通過審核後，可獲得商家配音。

驗證

表示該地點需要驗證。內含目前在該地區所執行的驗證動作相關資訊。

JSON 表示法 
{
  "hasPendingVerification": boolean
}
欄位
hasPendingVerification

boolean

指出驗證程序是否已開始，且可由營業地點完成。

ResolveOwnershipConflict

這個類型沒有任何欄位。

表示該地點與其他信譽良好的地點重複。

ComplyWithGuidelines

表示該地點不符合我們的規範。

JSON 表示法 
{
  "recommendationReason": enum (RecommendationReason)
}
欄位
recommendationReason

enum (RecommendationReason)

系統建議該地點遵循規範的原因。

RecommendationReason

說明我們為何建議該地區遵循 ComplyWithGuidelines。

列舉
RECOMMENDATION_REASON_UNSPECIFIED 不指定。
BUSINESS_LOCATION_SUSPENDED 商家所在地點遭停權。如要修正這個問題，請參閱說明中心文章。
BUSINESS_LOCATION_DISABLED 商家所在地點已停用。如要修正這個問題，請參閱說明中心文章。