Method: locations.getVoiceOfMerchantState

Pobiera stan VoiceOfMerchant.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu lokalizacji.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat odpowiedzi dla VoiceOfMerchant.GetVoiceOfMerchantState.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis 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.
}
Pola
hasVoiceOfMerchant

boolean

Wskazuje, czy lokalizacja jest w dobrym stanie i czy ma kontrolę nad firmą w Google. Wszelkie zmiany wprowadzone w lokalizacji zostaną przeniesione do Map po przejściu fazy weryfikacji.
hasBusinessAuthority

boolean

Wskazuje, czy lokalizacja ma uprawnienia (prawo własności) do firmy w Google. Jeśli tak, inna lokalizacja nie może przejąć i stać się dominującą wizytówką w Mapach. Zmiany nie zostaną jednak opublikowane, dopóki nie uzyskasz statusu Voice of Merchant (czyli hasVoiceOfMerchant ma wartość true).
Działanie zalecane w przypadku lokalizacji, aby uzyskać kontrolę nad firmą w Google. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
waitForVoiceOfMerchant

object (WaitForVoiceOfMerchant)

poczekać na uzyskanie opinii sprzedawcy, Lokalizacja jest sprawdzana pod kątem jakości.
verify

object (Verify)

rozpocząć lub kontynuować proces weryfikacji;
resolveOwnershipConflict

object (ResolveOwnershipConflict)

Ta lokalizacja jest duplikatem innej lokalizacji, która jest w dobrym stanie. Jeśli masz dostęp do lokalizacji w dobrym stanie, użyj jej identyfikatora, aby wykonywać operacje. W przeciwnym razie poproś obecnego właściciela o dostęp.
complyWithGuidelines

object (ComplyWithGuidelines)

Lokalizacja jest niezgodna z naszymi wytycznymi i wymaga dodatkowych działań, aby można było ją przywrócić. Aby rozwiązać ten problem, zapoznaj się z tym artykułem w Centrum pomocy.
Koniec pól wykluczających się wzajemnie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

WaitForVoiceOfMerchant

Ten typ nie ma pól.

Wskazuje, że po przejściu weryfikacji lokalizacja uzyska dostęp do opinii klientów.

Zweryfikuj

Wskazuje, że lokalizacja wymaga weryfikacji. Zawiera informacje o bieżących działaniach weryfikacyjnych wykonywanych w lokalizacji.

Zapis JSON 
{
  "hasPendingVerification": boolean
}
Pola
hasPendingVerification

boolean

Wskazuje, czy proces weryfikacji już się rozpoczął i czy można go dokończyć w lokalizacji.

ResolveOwnershipConflict

Ten typ nie ma pól.

Wskazuje, że lokalizacja jest duplikatem innej lokalizacji, która jest w dobrym stanie.

ComplyWithGuidelines

Wskazuje, że lokalizacja nie jest zgodna z naszymi wytycznymi.

Zapis JSON 
{
  "recommendationReason": enum (RecommendationReason)
}
Pola
recommendationReason

enum (RecommendationReason)

Powód, dla którego lokalizacja jest zalecana, aby spełniać wytyczne.

RecommendationReason

Wskazuje, dlaczego lokalizacja została zarekomendowana do ComplyWithGuidelines.

Wartości w polu enum
RECOMMENDATION_REASON_UNSPECIFIED Nie określono.
BUSINESS_LOCATION_SUSPENDED Lokalizacja firmy jest zawieszona. Aby rozwiązać ten problem, zapoznaj się z tym artykułem w Centrum pomocy.
BUSINESS_LOCATION_DISABLED Lokalizacja firmy jest wyłączona. Aby rozwiązać ten problem, zapoznaj się z tym artykułem w Centrum pomocy.