Package google.mybusiness.verifications.v1

Indice

Verifiche

Questa API consente di gestire le verifiche della posizione su Google. Ti consente di gestire le risorse [Verifica] [google.mybusiness.v1.Verification].

Ogni [località] [google.mybusiness.businessinformation.locations.v1.Location] dispone di una raccolta di risorse di [Verifica] [google.mybusiness.verifications], denominata locations/*/verifications/*.

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

Completa una verifica con PENDING.

È necessario solo per i metodi di verifica non AUTO. La richiesta di verifica di AUTO sarà VERIFIED immediatamente dopo la creazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

Segnala tutte le opzioni di verifica idonee per una sede in una lingua specifica.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

Elenca le verifiche di una sede, ordinate in base all'ora di creazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

Avvia la procedura di verifica di una sede.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

VoiceOfMerchant

Questo servizio consente agli utenti di terze parti di richiedere dettagli sulla voce dello stato del commerciante.

GetVoiceOfMerchantState

rpc GetVoiceOfMerchantState(GetVoiceOfMerchantStateRequest) returns (VoiceOfMerchantState)

Restituisce lo stato VoiceOfMerchant.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

CompleteVerificationRequest

Messaggio di richiesta per Verifications.CompleteVerificaAction.

Campi
name

string

Obbligatorio. Nome risorsa della verifica da completare.
pin

string

Obbligatorio. Codice PIN ricevuto dal commerciante per completare la verifica.

CompleteVerificationResponse

Messaggio di risposta per Verifications.CompleteVerificaAction.

Campi
verification

Verification

La verifica è stata completata.

ComplyWithGuidelines

Indica che la sede non rispetta le nostre linee guida.

Campi
recommendation_reason

RecommendationReason

Il motivo per cui viene consigliato che la sede sia conforme alle linee guida.

RecommendationReason

Indica perché la posizione è stata consigliata per ComplyWithGuidelines.

Enum
RECOMMENDATION_REASON_UNSPECIFIED Non specificato.
BUSINESS_LOCATION_SUSPENDED La sede dell'attività è sospesa. Per risolvere il problema, leggi l'articolo del Centro assistenza.
BUSINESS_LOCATION_DISABLED La sede dell'attività è disattivata. Per risolvere il problema, leggi l'articolo del Centro assistenza.

FetchVerificationOptionsRequest

Messaggio di richiesta per Verifications.Fetch VerificationOptions.

Campi
location

string

Obbligatorio. La sede da verificare.
language_code

string

Obbligatorio. Il codice lingua BCP 47 che rappresenta la lingua da utilizzare per la procedura di verifica. Le opzioni disponibili variano in base alla lingua.
context

ServiceBusinessContext

Campo facoltativo. Informazioni aggiuntive sul contesto per la verifica delle attività di servizi. Può essere applicato solo alle sedi con tipo di attività CUSTOMER_LOCATION_only. Se specifichi un indirizzo preciso, potresti attivare più opzioni. Se impostato per altri tipi di sedi di attività commerciali, verrà visualizzato il valore INVALID_tto.

FetchVerificationOptionsResponse

Messaggio di risposta per Verifications.FetchVerificaOptions.

Campi
options[]

VerificationOption

Le opzioni di verifica disponibili.

GetVoiceOfMerchantStateRequest

Messaggio di richiesta per VoiceOfMerchant.GetVoiceOfMerchantState.

Campi
name

string

Obbligatorio. Nome risorsa della località.

ListVerificationsRequest

Messaggio di richiesta per Verifications.ListVerificas.

Campi
parent

string

Obbligatorio. Nome risorsa della località a cui appartengono le richieste di verifica.
page_size

int32

Il numero di verifiche da includere per pagina. Il valore minimo è 1, mentre la dimensione predefinita e massima è 100.
page_token

string

Se specificato, restituisce la pagina successiva di verifiche.

ListVerificationsResponse

Messaggio di risposta per Verifications.ListVerificas.

Campi
verifications[]

Verification

Elenco delle verifiche.
next_page_token

string

Se il numero di verifiche supera le dimensioni di pagina richieste, questo campo verrà completato con un token per recuperare la pagina di verifica successiva in una chiamata successiva. Se non ci sono altri attributi, questo campo non sarà presente nella risposta.

ResolveOwnershipConflict

Questo tipo non contiene campi.

Indica che la posizione duplica un'altra posizione con una buona reputazione.

ServiceBusinessContext

Dati aggiuntivi per la verifica dell'attività di servizi.

Campi
address

PostalAddress

L'indirizzo di verifica della sede. Viene utilizzato per attivare altre opzioni di verifica o per inviare una cartolina.

Verifica

Una verifica rappresenta un tentativo di verifica di una sede.

Campi
name

string

Nome risorsa della verifica.
method

VerificationMethod

Il metodo di verifica.
state

State

Lo stato della verifica.
create_time

Timestamp

Il timestamp del momento in cui viene richiesta la verifica.
announcement

string

Campo facoltativo. L'annuncio di risposta è impostato solo se il metodo è VETTED_PARTNER.

Stato

Tutti i possibili stati di verifica.

Enum
STATE_UNSPECIFIED Il valore predefinito causerà errori.
PENDING La verifica è in attesa.
COMPLETED La verifica è stata completata.
FAILED La verifica non è andata a buon fine.

VerificationMethod

Specifica i processi utilizzati da Google per verificare una sede.

Enum
VERIFICATION_METHOD_UNSPECIFIED Il valore predefinito causerà errori.
ADDRESS Inviare una cartolina con un PIN di verifica a un indirizzo postale specifico. Il PIN viene utilizzato per completare la verifica con Google.
EMAIL Inviare un'email con un PIN di verifica a un indirizzo email specifico. Il PIN viene utilizzato per completare la verifica con Google.
PHONE_CALL Effettuare una telefonata con un PIN di verifica a un numero di telefono specifico. Il PIN viene utilizzato per completare la verifica con Google.
SMS Invia un SMS con il PIN di verifica a un numero di telefono specifico. Il PIN viene utilizzato per completare la verifica con Google.
AUTO Verifica la sede senza ulteriori azioni dell'utente. Questa opzione potrebbe non essere disponibile per tutte le località.
VETTED_PARTNER Questa opzione potrebbe non essere disponibile per tutte le località.

VerificationOption

L'opzione di verifica rappresenta la modalità di verifica della sede (indicata in base al metodo di verifica) e la destinazione della verifica (indicata dai dati visualizzati).

Campi
verification_method

VerificationMethod

Metodo di verifica della sede.
Campo di unione DisplayData. Uno dei dati visualizzati. I dati devono corrispondere al metodo. Vuoto se il metodo corrispondente non ha dati di visualizzazione. DisplayData può essere solo uno dei seguenti:
phone_number

string

Da impostare solo se il metodo è PHONE_CALL o SMS. Numero di telefono a cui verrà inviato il PIN.
address_data

AddressVerificationData

Da impostare solo se il metodo è MAIL.
email_data

EmailVerificationData

Impostalo solo se il metodo è EMAIL.
announcement

string

Impostalo solo se il metodo è VETTED_PARTNER.

AddressVerificationData

Mostra i dati per le verifiche tramite cartolina.

Campi
business

string

Nome dell'attività del commerciante.
address

PostalAddress

Indirizzo a cui può essere inviata una cartolina.
expected_delivery_days_region

int32

Numero previsto di giorni necessari per consegnare una cartolina nella regione dell'indirizzo.

EmailVerificationData

Mostra i dati per le verifiche via email.

Campi
domain

string

Nome di dominio nell'indirizzo email, ad esempio "gmail.com" in foo@gmail.com
user

string

Nome utente nell'indirizzo email, ad esempio "foo" in foo@gmail.com
is_user_name_editable

bool

Indica se il client è autorizzato a fornire un nome utente diverso.

VerificationToken

Token generato da un partner verificato.

Campi
token_string

string

La stringa token.

Verifica

Indica che la località richiede la verifica. Contiene informazioni sulle azioni di verifica attualmente eseguite nella sede.

Campi
has_pending_verification

bool

Indica se una procedura di verifica è già iniziata e può essere completata dalla sede.

VerifyLocationRequest

Messaggio di richiesta per Verifications.VerifyLocation.

Campi
name

string

Obbligatorio. Nome risorsa della località da verificare.
method

VerificationMethod

Obbligatorio. Metodo di verifica.
language_code

string

Campo facoltativo. Il codice lingua BCP 47 che rappresenta la lingua da utilizzare per la procedura di verifica.
context

ServiceBusinessContext

Campo facoltativo. Informazioni aggiuntive sul contesto per la verifica delle attività di servizi. È obbligatorio solo per le sedi il cui tipo di attività è CUSTOMER_LOCATION_only. Per la verifica di ADDRESS, l'indirizzo verrà utilizzato per l'invio della cartolina. Per gli altri metodi, deve essere uguale a quello trasmesso a GetVerificaOptions. Se impostato per altri tipi di sedi di attività commerciali, viene visualizzato il valore INVALID_gna.
Campo di unione RequestData. Dati di input dell'utente per un metodo specifico oltre ai dati di visualizzazione. I dati devono corrispondere al metodo richiesto. Lascia vuoto il campo se non sono necessari dati. RequestData può essere solo uno dei seguenti:
email_address

string

Campo facoltativo. Input per il metodo EMAIL. Indirizzo email a cui inviare il PIN.

Un indirizzo email viene accettato solo se è uno degli indirizzi forniti da Fetch VerificationOptions. Se il valore di [EmailVerificaData] [google.mybusiness-verifications.v1.VerificaOption.EmailVerificaData] è impostato su true, il cliente può specificare un nome utente diverso (parte locale), ma deve corrispondere al nome di dominio.
mailer_contact

string

Campo facoltativo. Input per il metodo ADDRESS. Nome di contatto a cui deve essere inviata la posta.
phone_number

string

Campo facoltativo. Input per il metodo PHONE_CALL/SMS Il numero di telefono da chiamare o a cui inviare un SMS. Deve essere uno dei numeri di telefono presenti nelle opzioni idonee.
token

VerificationToken

Campo facoltativo. Input per il metodo VETTED_PARTNER disponibile per selezionare i partners.. Questo input non è necessario per un account verificato. Token associato alla località. Token associato alla località.

VerifyLocationResponse

Messaggio di risposta per Verifications.VerifyLocation.

Campi
verification

Verification

La richiesta di verifica creata.

VoiceOfMerchantState

Messaggio di risposta per VoiceOfMerchant.GetVoiceOfMerchantState.

Campi
has_voice_of_merchant

bool

Indica se la sede è in regola e ha il controllo dell'attività su Google. Eventuali modifiche apportate alla sede verranno propagate a Maps dopo aver superato la fase di revisione.
has_business_authority

bool

Indica se la sede ha l'autorità (proprietà) sull'attività commerciale su Google. Se il valore è vero, un'altra località non può sostituire la scheda e diventare la scheda principale su Maps. Tuttavia, le modifiche non verranno pubblicate a meno che non venga acquisita da Voice of Merchant (ad esempio, has_voice_of_merchant è true).
Campo di unione gain_voice_of_merchant_action. Azione consigliata nella sede per acquisire il controllo dell'attività su Google. gain_voice_of_merchant_action può essere solo uno dei seguenti:
wait_for_voice_of_merchant

WaitForVoiceOfMerchant

Attendi per ottenere Voice of Merchant. La sede è in corso di revisione ai fini della qualità.
verify

Verify

Avvia o continua la procedura di verifica.
resolve_ownership_conflict

ResolveOwnershipConflict

Questa posizione duplica un'altra sede con una buona reputazione. Se hai accesso alla posizione in regola, utilizza l'ID della posizione per eseguire le operazioni. In caso contrario, richiedi l'accesso al proprietario attuale.
comply_with_guidelines

ComplyWithGuidelines

La sede non rispetta le nostre linee guida e richiede ulteriori passaggi per il reintegro. Per risolvere il problema, leggi questo articolo del Centro assistenza.

WaitForVoiceOfMerchant

Questo tipo non contiene campi.

Indica che la località prenderà voce dal commerciante dopo aver superato la revisione.