WebResource: getToken

  • Retrieves a verification token for website or domain ownership verification upon authorization.

  • Supports various verification methods including ANALYTICS, DNS, DNS_CNAME, DNS_TXT, FILE, META, and TAG_MANAGER.

  • Requires specifying the site type (SITE, INET_DOMAIN, or ANDROID_APP) and identifier (URL or domain name).

  • Returns the selected verification method and the corresponding token to be placed on the site.

  • Authorization is required with the siteverification or siteverification.verify_only scope.

Requires authorization

Gets a verification token for the authenticated user to place on a website or domain. Try it now.

Request

HTTP request

POST https://www.googleapis.com/siteVerification/v1/token

Authorization

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/siteverification
https://www.googleapis.com/auth/siteverification.verify_only

Request body

In the request body, supply data with the following structure:

{
  "site": {
    "type": string,
    "identifier": string
  },
  "verificationMethod": string
}
Property name Value Description Notes
site object Container for the address and type of a site for which a verification token will be generated.
site.type string The type of resource to be verified.

Acceptable values are:
  • "ANDROID_APP"
  • "INET_DOMAIN"
  • "SITE"
site.identifier string The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the identifier is a domain name.
verificationMethod string The verification method for the Site Verification system to use to verify this site or domain.

Acceptable values are:
  • "ANALYTICS":  Sites only
  • "DNS": Use DNS_TXT instead
  • "DNS_CNAME": Domains only
  • "DNS_TXT": Domains only
  • "FILE": Sites only
  • "META": Sites only
  • "TAG_MANAGER": Sites only

Response

If successful, this method returns a response body with the following structure:

{
  "method": string,
  "token": string
}
Property name Value Description Notes
method string The verification method that you selected in the request.

Acceptable values are:
  • "ANALYTICS"
  • "DNS"
  • "DNS_CNAME"
  • "DNS_TXT"
  • "FILE"
  • "META"
  • "TAG_MANAGER"
token string The string to place on the authenticated user's site, using the selected verification method. For more information, see Verification methods and tokens in the Getting Started document.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.