Method: locations.getVoiceOfMerchantState

取得 VoiceOfMerchant 狀態。

HTTP 要求

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

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

路徑參數

參數
name

string

必填。位置的資源名稱。

要求主體

要求主體必須為空白。

回應主體

VoiceOfMerchant.GetVoiceOfMerchantState 的回應訊息。

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "waitForVoiceOfMerchant": {
    object (WaitForVoiceOfMerchant)
  },
  "verify": {
    object (Verify)
  },
  "resolveOwnershipConflict": {
    object (ResolveOwnershipConflict)
  },
  "complyWithGuidelines": {
    object (ComplyWithGuidelines)
  }
  // End of mutually exclusive fields.
}
欄位
hasVoiceOfMerchant

boolean

指出地點是否記錄良好，且可控管 Google 上的商家。對地點所做的任何編輯，在通過審查階段後都會套用至 Google 地圖。
hasBusinessAuthority

boolean

指出該地點是否擁有 Google 商家資訊的授權 (擁有權)。如果為 true，其他地點就無法取代該地點，成為 Google 地圖上的主要商家資訊。不過，除非取得商家之聲 (即 hasVoiceOfMerchant 為 true)，否則編輯內容不會生效。
建議對該地點採取的行動，以便在 Google 上控管商家。以下列出互斥欄位。回應中最多會設定下列其中一個欄位：
waitForVoiceOfMerchant

object (WaitForVoiceOfMerchant)

等待取得「商家意見」功能。為確保品質，我們正在審查這個地點。
verify

object (Verify)

開始或繼續驗證程序。
resolveOwnershipConflict

object (ResolveOwnershipConflict)

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

object (ComplyWithGuidelines)

地點不符合規範，需要採取額外步驟才能恢復。如要修正這個問題，請參閱說明中心文章。
互斥欄位結束。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。

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 商家所在地點已停用。如要修正這個問題，請參閱說明中心文章。