Method: locations.getVoiceOfMerchantState

Получает статус VoiceOfMerchant.

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

Параметры пути

Параметры
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. Все изменения, внесенные в адрес, будут отражены на Картах после прохождения проверки.
hasBusinessAuthority

boolean

Указывает, есть ли у адреса право собственности на компанию в Google. Если значение true, то другое местоположение не может стать основным на Картах. Однако изменения не будут опубликованы, пока вы не получите статус Voice of Merchant (то есть пока для hasVoiceOfMerchant не будет установлено значение true).
Рекомендуемое действие для адреса, чтобы получить контроль над компанией в Google. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
waitForVoiceOfMerchant

object (WaitForVoiceOfMerchant)

Дождитесь, пока вам будет предоставлено право голоса. Адрес проверяется на соответствие правилам.
verify

object (Verify)

Начните или продолжите процедуру проверки.
resolveOwnershipConflict

object (ResolveOwnershipConflict)

Этот адрес дублирует другой адрес с хорошей репутацией. Если у вас есть доступ к адресу с хорошей репутацией, используйте его идентификатор для выполнения операций. В противном случае запросите доступ у текущего владельца.
complyWithGuidelines

object (ComplyWithGuidelines)

Адрес не соответствует нашим правилам, и для его восстановления требуются дополнительные действия. Чтобы устранить эту проблему, ознакомьтесь со статьей Справочного центра.
Конец взаимоисключающих полей.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию вы найдете в OAuth 2.0 Overview.

WaitForVoiceOfMerchant

У этого типа нет полей.

Указывает, что адрес получит статус Voice of Merchant после прохождения проверки.

Подтвердить

Указывает, что адрес требует подтверждения. Содержит информацию о текущих действиях по подтверждению, выполненных для адреса.

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 Адрес компании отключен. Чтобы устранить эту проблему, ознакомьтесь со статьей Справочного центра.