Package google.mybusiness.verifications.v1

Indeks

Licencje

Ten interfejs API umożliwia zarządzanie weryfikacją lokalizacji w Google. Pozwala zarządzać zasobami [Weryfikacja] [google.mybusiness.v1.verification].

Każda [lokalizacja] [google.mybusiness.businessinformation.locations.v1.Location] zawiera zbiór zasobów o nazwie locations/*/verifications/* [Weryfikacja] [google.mybusiness.verifications].

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

Przechodzi weryfikację w PENDING.

Jest to konieczne tylko w przypadku metod weryfikacji innych niż AUTO. Prośba o weryfikację AUTO jest wysyłana od razu VERIFIED po utworzeniu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

Raportuje wszystkie kwalifikujące się opcje weryfikacji dla lokalizacji w określonym języku.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

Wyświetl listę weryfikacji lokalizacji posortowanych według czasu utworzenia.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

Rozpoczyna proces weryfikacji lokalizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

VoiceOfMerchant

Ta usługa pozwala użytkownikom zewnętrznym na wysyłanie próśb o szczegółowe informacje o stanie sprzedawcy.

GetVoiceOfMerchantState

rpc GetVoiceOfMerchantState(GetVoiceOfMerchantStateRequest) returns (VoiceOfMerchantState)

Pobiera stan VoiceOfMerchant.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

CompleteVerificationRequest

Prośba o wiadomość dla funkcji Verifications.CompleteVerifyAction.

Pola
name

string

To pole jest wymagane. Nazwa zasobu weryfikacji do ukończenia.
pin

string

To pole jest wymagane. Kod PIN otrzymany przez sprzedawcę do ukończenia weryfikacji.

CompleteVerificationResponse

Odpowiedź na pytanie Weryfikacjas.CompleteVerifyAction.

Pola
verification

Verification

Ukończona weryfikacja.

ComplyWithGuidelines

wskazuje, że lokalizacja jest niezgodna z naszymi wytycznymi.

Pola
recommendation_reason

RecommendationReason

Powód, dla którego lokalizacja jest rekomendowana w celu zachowania zgodności z wytycznymi.

RecommendationReason

Wskazuje, dlaczego lokalizacja została rekomendowana jako ComplyWithGuidelines.

Wartości w polu enum
RECOMMENDATION_REASON_UNSPECIFIED Nie określono.
BUSINESS_LOCATION_SUSPENDED Lokalizacja firmy została zawieszona. Aby rozwiązać ten problem, przeczytaj ten artykuł w Centrum pomocy.
BUSINESS_LOCATION_DISABLED Lokalizacja firmy jest wyłączona. Aby rozwiązać ten problem, przeczytaj ten artykuł w Centrum pomocy.

FetchVerificationOptionsRequest

Poproś o wiadomość na temat Verifications.FetchVerifyOptions.

Pola
location

string

To pole jest wymagane. Lokalizacja do zweryfikowania.
language_code

string

To pole jest wymagane. Kod języka BCP 47 wskazujący język, który ma być użyty w procesie weryfikacji. Dostępne opcje różnią się w zależności od języka.
context

ServiceBusinessContext

Opcjonalnie. Dodatkowe informacje kontekstowe na potrzeby weryfikacji firm świadczących usługi. Można stosować tylko dla lokalizacji, których typ działalności to CUSTOMER_LOCATION_ONLY. Jeśli podasz dokładny adres, zyskasz więcej opcji. Wartość Część IARC zostanie odrzucona, jeśli jest ustawiona dla lokalizacji innego typu firmy.

FetchVerificationOptionsResponse

Odpowiedź na żądanie Verifications.FetchVerifyOptions.

Pola
options[]

VerificationOption

Dostępne opcje weryfikacji.

GetVoiceOfMerchantStateRequest

Prośba o wiadomość dotyczącą VoiceOfMerchant.GetVoiceOfMerchantState.

Pola
name

string

To pole jest wymagane. Nazwa zasobu lokalizacji.

ListVerificationsRequest

Prośba o wiadomość dotyczącą funkcji Verifications.Listverifications.

Pola
parent

string

To pole jest wymagane. Nazwa zasobu lokalizacji, do której należą prośby o weryfikację.
page_size

int32

Ile elementów weryfikacyjnych należy umieścić na stronie. Wartość minimalna to 1, a domyślny i maksymalny rozmiar strony to 100.
page_token

string

Jeśli określono wartość, zwraca następną stronę weryfikacji.

ListVerificationsResponse

Odpowiedź na pytanie Verifications.Listverifications.

Pola
verifications[]

Verification

Lista weryfikacji.
next_page_token

string

Jeśli liczba weryfikacji przekracza żądany rozmiar strony, w tym polu pojawi się token służący do pobierania następnej strony weryfikacji podczas kolejnego wywołania. Jeśli nie ma więcej atrybutów, to pole nie będzie obecne w odpowiedzi.

ResolveOwnershipConflict

Ten typ nie ma pól.

wskazuje, że lokalizacja jest duplikatem innej lokalizacji, która cieszy się dobrą opinią.

ServiceBusinessContext

Dodatkowe dane na potrzeby weryfikacji firmy usługowej.

Pola
address

PostalAddress

Adres weryfikacyjny lokalizacji. Służy on do włączania dodatkowych opcji weryfikacji lub wysyłania kartki pocztowej.

Weryfikacja

Weryfikacja to próba weryfikacji lokalizacji.

Pola
name

string

Nazwa zasobu weryfikacji.
method

VerificationMethod

Metoda weryfikacji.
state

State

Stan weryfikacji.
create_time

Timestamp

Sygnatura czasowa wysłania prośby o weryfikację.
announcement

string

Opcjonalnie. Odpowiedź jest ustawiana tylko wtedy, gdy metodą jest VETTED_PARTNER.

Stan

Wszystkie możliwe stany weryfikacji.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, spowoduje błędy.
PENDING Oczekiwanie na weryfikację.
COMPLETED Weryfikacja zakończona.
FAILED Weryfikacja się nie powiodła.

VerificationMethod

Określa procesy używane przez Google do weryfikowania lokalizacji.

Wartości w polu enum
VERIFICATION_METHOD_UNSPECIFIED Wartość domyślna, spowoduje błędy.
ADDRESS Wyślij na określony adres pocztowy kartkę pocztową z kodem weryfikacyjnym. Kod PIN jest używany do zakończenia weryfikacji w Google.
EMAIL Wyślij e-maila z weryfikacyjnym kodem PIN na określony adres e-mail. Kod PIN jest używany do zakończenia weryfikacji w Google.
PHONE_CALL Możesz zadzwonić pod konkretny numer telefonu, używając weryfikacyjnego kodu PIN. Kod PIN jest używany do zakończenia weryfikacji w Google.
SMS Wyślij SMS-a z weryfikacyjnym kodem PIN na określony numer telefonu. Kod PIN jest używany do zakończenia weryfikacji w Google.
AUTO Potwierdź lokalizację bez dodatkowego działania ze strony użytkownika. Ta opcja może nie być dostępna we wszystkich lokalizacjach.
VETTED_PARTNER Ta opcja może nie być dostępna we wszystkich lokalizacjach.

VerificationOption

Opcja weryfikacji reprezentuje sposób weryfikacji lokalizacji (wskazana metodą weryfikacji) i miejsce, do którego zostanie przekierowana weryfikacja (na podstawie wyświetlonych danych).

Pola
verification_method

VerificationMethod

Metoda weryfikacji lokalizacji.
Pole sumy DisplayData. Jeden z wyświetlanych danych. Dane muszą być zgodne z metodą. Puste, jeśli odpowiednia metoda nie ma żadnych wyświetlanych danych. DisplayData może mieć tylko jedną z tych wartości:
phone_number

string

Ustaw tylko wtedy, gdy metoda to PHONE_CALL lub SMS. Numer telefonu, na który zostanie wysłany kod PIN.
address_data

AddressVerificationData

Ustaw tylko wtedy, gdy metoda to MAIL.
email_data

EmailVerificationData

Ustaw tylko wtedy, gdy metoda to EMAIL.
announcement

string

Ustaw tylko wtedy, gdy metoda to VETTED_PARTNER.

AddressVerificationData

Wyświetl dane na potrzeby weryfikacji za pomocą kartki pocztowej.

Pola
business

string

Nazwa firmy sprzedawcy.
address

PostalAddress

Adres, na który można wysłać kartkę pocztową.
expected_delivery_days_region

int32

Oczekiwana liczba dni na dostarczenie kartki pocztowej do regionu, w którym znajduje się adres.

EmailVerificationData

Wyświetlanie danych na potrzeby weryfikacji przez e-mail.

Pola
domain

string

Nazwa domeny w adresie e-mail, np. „gmail.com” w foo@gmail.com
user

string

Nazwa użytkownika w adresie e-mail. np. „foo” w foo@gmail.com
is_user_name_editable

bool

Określa, czy klient może podać inną nazwę użytkownika.

VerificationToken

Token wygenerowany przez zweryfikowanego partnera.

Pola
token_string

string

Ciąg tokena.

Zweryfikuj

Wskazuje, że lokalizacja wymaga weryfikacji. Zawiera informacje o aktualnych działaniach weryfikacyjnych wykonanych w danej lokalizacji.

Pola
has_pending_verification

bool

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

VerifyLocationRequest

Prośba o wiadomość dotyczącą weryfikacji: Verifications.VerifyLocation.

Pola
name

string

To pole jest wymagane. Nazwa zasobu lokalizacji do zweryfikowania.
method

VerificationMethod

To pole jest wymagane. Metoda weryfikacji.
language_code

string

Opcjonalnie. Kod języka BCP 47 wskazujący język, który ma być użyty w procesie weryfikacji.
context

ServiceBusinessContext

Opcjonalnie. Dodatkowe informacje kontekstowe na potrzeby weryfikacji firm świadczących usługi. Jest to wymagane tylko w przypadku lokalizacji, których typ działalności to CUSTOMER_LOCATION_ONLY. W przypadku weryfikacji ADRESU adres zostanie użyty do wysłania kartki pocztowej. W przypadku innych metod powinna być taka sama jak ta, która jest przekazywana do GetVerifyOptions. W przypadku innego typu lokalizacji firmy zostanie wysłane żądanie IARC_anie.
Pole sumy RequestData. Oprócz danych wyświetlanych przez użytkownika dane wejściowe związane z określoną metodą. Dane muszą być zgodne z żądaną metodą. Jeśli dane nie są potrzebne, pozostaw to pole puste. RequestData może mieć tylko jedną z tych wartości:
email_address

string

Opcjonalnie. Dane wejściowe metody EMAIL. Adres e-mail, na który ma zostać wysłany kod PIN.

Adres e-mail jest akceptowany tylko wtedy, gdy jest to jeden z adresów podanych przez funkcję FetchVerifyOptions. Jeśli w polu [EmailVerifyData] [google.mybusiness-verifications.v1.verificationOption.EmailVerifyData] jest ustawiona wartość [prawda], klient może użyć innej nazwy użytkownika (części lokalnej), ale musi ona być zgodna z nazwą domeny.
mailer_contact

string

Opcjonalnie. Dane wejściowe metody ADDRESS. Nazwa kontaktu, do którego należy wysyłać pocztę.
phone_number

string

Opcjonalnie. Dane wejściowe metody PHONE_CALL/SMS Numer telefonu, na który należy zadzwonić lub na który ma zostać wysłany SMS. Musi to być jeden z numerów telefonu dostępnych w odpowiednich opcjach.
token

VerificationToken

Opcjonalnie. Dane wejściowe metody VETTED_PARTNER są dostępne dla wybranych partners.. Dane wejściowe nie są potrzebne w przypadku zweryfikowanego konta. Token powiązany z lokalizacją. Token powiązany z lokalizacją.

VerifyLocationResponse

Odpowiedź na pytanie Weryfikacjas.VerifyLocation.

Pola
verification

Verification

Utworzono prośbę o weryfikację.

VoiceOfMerchantState

Wiadomość z odpowiedzią na VoiceOfMerchant.GetVoiceOfMerchantState.

Pola
has_voice_of_merchant

bool

Wskazuje, czy lokalizacja ma dobrą opinię i ma kontrolę nad firmą w Google. Wszelkie zmiany wprowadzone w lokalizacji zostaną rozpowszechnione w Mapach po przejściu etapu weryfikacji.
has_business_authority

bool

Wskazuje, czy lokalizacja ma uprawnienia właściciela do firmy w Google. Jeśli ustawisz wartość prawda, inna lokalizacja nie może przejąć informacji o firmie i stać się dominującą lokalizacją w Mapach Google. Jednak zmiany nie zostaną opublikowane, dopóki nie zostanie uzyskana usługa Voice of Merchant (tzn. has_voice_of_merchant ma wartość prawda).
Pole sumy gain_voice_of_merchant_action. Zalecane działanie dla lokalizacji w celu uzyskania kontroli nad firmą w Google. gain_voice_of_merchant_action może mieć tylko jedną z tych wartości:
wait_for_voice_of_merchant

WaitForVoiceOfMerchant

Zaczekaj, aby uzyskać Voice of Merchant. Lokalizacja jest sprawdzana pod kątem jakości.
verify

Verify

Rozpocznij lub kontynuuj proces weryfikacji.
resolve_ownership_conflict

ResolveOwnershipConflict

Ta lokalizacja jest duplikatem innej lokalizacji, która ma dobrą opinię. Jeśli masz dostęp do lokalizacji, która ma dobrą opinię, do wykonywania operacji użyj identyfikatora tej lokalizacji. W przeciwnym razie poproś obecnego właściciela o dostęp.
comply_with_guidelines

ComplyWithGuidelines

Lokalizacja jest niezgodna z naszymi wytycznymi i wymaga dodatkowych czynności, aby ją przywrócić. Aby rozwiązać ten problem, przeczytaj ten artykuł w Centrum pomocy.

WaitForVoiceOfMerchant

Ten typ nie ma pól.

Wskazuje, że po sprawdzeniu lokalizacji sprzedawca uzyska głos sprzedawcy.