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 of Merchant (如 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

指出建議地點遵循規範的原因。

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