The Verifications API and Business Information API is now launched! Migration work is required. Please see our deprecation schedule for more information related to deprecated endpoints. You may also sign up for our mailing list to receive updates.

Method: verificationTokens.generate

Generates a token for the provided location data as a vetted partner.

Throws PERMISSION_DENIED if the caller is not a vetted partner account. Throws FAILED_PRECONDITION if the caller's VettedStatus is INVALID.

HTTP request

POST https://mybusinessverifications.googleapis.com/v1/verificationTokens:generate

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{
  "location": {
    object (Location)
  }
}
Fields
location

object (Location)

Required. The target location.

Response body

If successful, the response body contains data with the following structure:

Response message for Verifications.GenerateVerificationToken.

JSON representation
{
  "token": {
    object (VerificationToken)
  }
}
Fields
token

object (VerificationToken)

The generated token to verify the location.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

Location

A subset of location info. See the help center article for a detailed description of these fields, or the category endpoint for a list of valid business categories.

JSON representation
{
  "name": string,
  "primaryPhone": string,
  "address": {
    object (PostalAddress)
  },
  "primaryCategoryId": string,
  "websiteUri": string
}
Fields
name

string

Required. Location name should reflect your business's real-world name, as used consistently on your storefront, website, and stationery, and as known to customers. Any additional information, when relevant, can be included in other fields of the resource (for example, Address, Categories). Don't add unnecessary information to your name (for example, prefer "Google" over "Google Inc. - Mountain View Corporate Headquarters"). Don't include marketing taglines, store codes, special characters, hours or closed/open status, phone numbers, website URLs, service/product information, location/address or directions, or containment information (for example, "Chase ATM in Duane Reade").

primaryPhone

string

Optional. A phone number that connects to your individual business location as directly as possible. Use a local phone number instead of a central, call center helpline number whenever possible.

address

object (PostalAddress)

Required. A precise, accurate address to describe your business location. PO boxes or mailboxes located at remote locations are not acceptable. At this time, you can specify a maximum of five addressLines values in the address.

primaryCategoryId

string

Required. Id of the category that best describes the core business this location engages in.

websiteUri

string

Optional. A URL for this business. If possible, use a URL that represents this individual business location instead of a generic website/URL that represents all locations, or the brand.