L'API
Google Business Performance ha un metodo
NOVITÀ che consente di recuperare più `dailyMetrics` in un'unica richiesta API.
Consulta il
calendario del ritiro e le istruzioni per eseguire la migrazione dal metodo API ReportInsights della versione 4 all'API Performance di Google Profilo.
Method: locations.verify
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Avvia la procedura di verifica per una sede.
Richiesta HTTP
POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
name |
string
Obbligatorio. Nome risorsa della località da verificare.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"method": enum (VerificationMethod),
"languageCode": string,
"context": {
object (ServiceBusinessContext)
},
// Union field RequestData can be only one of the following:
"emailAddress": string,
"mailerContact": string,
"phoneNumber": string,
"token": {
object (VerificationToken)
}
// End of list of possible types for union field RequestData.
} |
| Campi |
method |
enum (VerificationMethod)
Obbligatorio. Metodo di verifica.
|
languageCode |
string
(Facoltativo) Il codice lingua BCP 47 che rappresenta la lingua da utilizzare per la procedura di verifica.
|
context |
object (ServiceBusinessContext)
(Facoltativo) Informazioni contestuali aggiuntive per la verifica delle attività di servizi. È obbligatorio solo per le sedi il cui tipo di attività è CUSTOMER_LOCATION_ONLY. Per la verifica dell'indirizzo ADDRESS, l'indirizzo verrà utilizzato per l'invio della cartolina postale. Per gli altri metodi, deve essere uguale a quello trasmesso a GetVerifyOptions. Se è impostato per altri tipi di sedi dell'attività commerciale, verrà visualizzato il valore INVALID_ARGUMENT.
|
Campo 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: |
emailAddress |
string
(Facoltativo) Il valore inserito per il metodo EMAIL. Indirizzo email a cui inviare il PIN. L'indirizzo email viene accettato solo se è uno degli indirizzi forniti da locations.fetchVerificaOptions. Se [EmailVerificaData]
[google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] ha il valore isUserNameEditable impostato su true, il cliente potrebbe specificare un nome utente diverso (parte locale), ma deve corrispondere al nome di dominio.
|
mailerContact |
string
(Facoltativo) Input per il metodo ADDRESS. Nome del contatto a cui inviare la posta.
|
phoneNumber |
string
(Facoltativo) Input per il metodo PHONE_CALL/SMS Il numero di telefono a cui effettuare la chiamata o a cui inviare un SMS. Deve essere uno dei numeri di telefono presenti nelle opzioni idonee.
|
token |
object (VerificationToken)
(Facoltativo) L'input per il metodo VETTED_PARTNER disponibile per partner selezionati. L'input non è necessario per un account verificato. Token associato alla località. Token associato alla località.
|
Corpo della risposta
Messaggio di risposta relativo a Verifications.VerifyLocation.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"verification": {
object (Verification)
}
} |
| Campi |
verification |
object (Verification)
La richiesta di verifica creata.
|
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.
VerificationToken
Token generato da un partner verificato.
| Rappresentazione JSON |
{
"tokenString": string
} |
| Campi |
tokenString |
string
La stringa del token.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eInitiates the verification process for a specified location using various methods like email, phone, address, or a vetted partner token.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the location's resource name and selecting the desired verification method.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, you can specify language, service business context, and user input data depending on the chosen method.\u003c/p\u003e\n"],["\u003cp\u003eA successful verification request returns a Verification object representing the initiated process.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This documentation details how to initiate a location verification process via a POST request to `https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify`. The request requires a location's resource `name` as a path parameter. The request body uses JSON and specifies the verification `method`, optional `languageCode` and `context` and the `RequestData` which could include an `emailAddress`, `mailerContact`, `phoneNumber`, or a `token`. A successful request returns a `verification` object in the JSON response body. An `Authorization scope` is required.\n"],null,["# Method: locations.verify\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.VerifyLocationResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [VerificationToken](#VerificationToken)\n - [JSON representation](#VerificationToken.SCHEMA_REPRESENTATION)\n\nStarts the verification process for a location.\n\n### HTTP request\n\n`POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the location to verify. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"method\": enum (/my-business/reference/verifications/rest/v1/VerificationMethod), \"languageCode\": string, \"context\": { object (/my-business/reference/verifications/rest/v1/ServiceBusinessContext) }, // Union field `RequestData` can be only one of the following: \"emailAddress\": string, \"mailerContact\": string, \"phoneNumber\": string, \"token\": { object (/my-business/reference/verifications/rest/v1/locations/verify#VerificationToken) } // End of list of possible types for union field `RequestData`. } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `method` | `enum (`[VerificationMethod](/my-business/reference/verifications/rest/v1/VerificationMethod)`)` Required. Verification method. |\n| `languageCode` | `string` Optional. The BCP 47 language code representing the language that is to be used for the verification process. |\n| `context` | `object (`[ServiceBusinessContext](/my-business/reference/verifications/rest/v1/ServiceBusinessContext)`)` Optional. Extra context information for the verification of service businesses. It is only required for the locations whose business type is CUSTOMER_LOCATION_ONLY. For ADDRESS verification, the address will be used to send out postcard. For other methods, it should be the same as the one that is passed to GetVerificationOptions. INVALID_ARGUMENT will be thrown if it is set for other types of business locations. |\n| Union field `RequestData`. User input data for specific method in addition to the display data. The data must match the requested method. Leave it empty if no data is needed. `RequestData` can be only one of the following: ||\n| `emailAddress` | `string` Optional. The input for EMAIL method. Email address where the PIN should be sent to. An email address is accepted only if it is one of the addresses provided by locations.fetchVerificationOptions. If the \\[EmailVerificationData\\] \\[google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData\\] has isUserNameEditable set to true, the client may specify a different user name (local-part) but must match the domain name. |\n| `mailerContact` | `string` Optional. The input for ADDRESS method. Contact name the mail should be sent to. |\n| `phoneNumber` | `string` Optional. The input for PHONE_CALL/SMS method The phone number that should be called or be sent SMS to. It must be one of the phone numbers in the eligible options. |\n| `token` | `object (`[VerificationToken](/my-business/reference/verifications/rest/v1/locations/verify#VerificationToken)`)` Optional. The input for VETTED_PARTNER method available to select [partners.](https://support.google.com/business/answer/7674102) The input is not needed for a vetted account. Token that is associated to the location. Token that is associated to the location. |\n\n### Response body\n\nResponse message for Verifications.VerifyLocation.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"verification\": { object (/my-business/reference/verifications/rest/v1/Verification) } } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------|\n| `verification` | `object (`[Verification](/my-business/reference/verifications/rest/v1/Verification)`)` The created verification request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nVerificationToken\n-----------------\n\nToken generated by a vetted [partner](https://support.google.com/business/answer/7674102).\n\n| JSON representation |\n|-----------------------------------|\n| ``` { \"tokenString\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------|\n| `tokenString` | `string` The token string. |"]]
