WebResource: getToken
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Richiede l'autorizzazione
Ottiene un token di verifica che l'utente autenticato deve inserire su un sito web o dominio.
Prova subito.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/siteVerification/v1/token
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
https://www.googleapis.com/auth/siteverification |
https://www.googleapis.com/auth/siteverification.verify_only |
Corpo della richiesta
Nel corpo della richiesta, fornisci i dati con la seguente struttura:
{
"site": {
"type": string,
"identifier": string
},
"verificationMethod": string
}
Nome proprietà |
Valore |
Descrizione |
Note |
site |
object |
Contenitore per l'indirizzo e il tipo di un sito per il quale verrà generato un token di verifica. |
|
site.type |
string |
Il tipo di risorsa da verificare.
I valori accettati sono:
- "
ANDROID_APP "
- "
INET_DOMAIN "
- "
SITE "
|
|
site.identifier |
string |
L'identificatore del sito. Se il tipo è impostato su SITE , l'identificatore è un URL. Se il tipo è impostato su INET_DOMAIN , l'identificatore è un nome di dominio. |
|
verificationMethod |
string |
Il metodo di verifica che il sistema di verifica del sito deve utilizzare per verificare questo sito o dominio.
I valori accettati sono:
- "
ANALYTICS ": solo siti
- "
DNS ": usa DNS_TXT
- "
DNS_CNAME ": solo domini
- "
DNS_TXT ": solo domini
- "
FILE ": solo siti
- "
META ": solo siti
- "
TAG_MANAGER ": solo siti
|
|
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"method": string,
"token": string
}
Nome proprietà |
Valore |
Descrizione |
Note |
method |
string |
Il metodo di verifica che hai selezionato nella richiesta.
I valori accettati sono:
- "
ANALYTICS "
- "
DNS "
- "
DNS_CNAME "
- "
DNS_TXT "
- "
FILE "
- "
META "
- "
TAG_MANAGER "
|
|
token |
string |
La stringa da inserire nel sito dell'utente autenticato, utilizzando il metodo di verifica selezionato. Per ulteriori informazioni, consulta la sezione Metodi di verifica e token nel documento Guida introduttiva. |
|
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
In alternativa, prova la
autonomo
Spazio di esplorazione.
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\u003eRetrieves a verification token for website or domain ownership verification upon authorization.\u003c/p\u003e\n"],["\u003cp\u003eSupports various verification methods including \u003ccode\u003eANALYTICS\u003c/code\u003e, \u003ccode\u003eDNS\u003c/code\u003e, \u003ccode\u003eDNS_CNAME\u003c/code\u003e, \u003ccode\u003eDNS_TXT\u003c/code\u003e, \u003ccode\u003eFILE\u003c/code\u003e, \u003ccode\u003eMETA\u003c/code\u003e, and \u003ccode\u003eTAG_MANAGER\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the site type (\u003ccode\u003eSITE\u003c/code\u003e, \u003ccode\u003eINET_DOMAIN\u003c/code\u003e, or \u003ccode\u003eANDROID_APP\u003c/code\u003e) and identifier (URL or domain name).\u003c/p\u003e\n"],["\u003cp\u003eReturns the selected verification method and the corresponding token to be placed on the site.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required with the \u003ccode\u003esiteverification\u003c/code\u003e or \u003ccode\u003esiteverification.verify_only\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["To get a verification token, send a POST request to the specified URL, including authorization with the correct scope. The request body must contain a `site` object with the `type` (e.g., `SITE`, `INET_DOMAIN`) and `identifier` (e.g., URL, domain name) of the site, as well as the desired `verificationMethod`. The successful response will return the chosen `method` and the `token` string to be placed on the site for verification.\n"],null,["# WebResource: getToken\n\n**Requires [authorization](#auth)**\n\nGets a verification token for the authenticated user to place on a website or domain.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/siteVerification/v1/token\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/site-verification/v1/getting_started#auth)).\n\n| Scope |\n|----------------------------------------------------------------|\n| `https://www.googleapis.com/auth/siteverification` |\n| `https://www.googleapis.com/auth/siteverification.verify_only` |\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```carbon\n{\n \"site\": {\n \"type\": string,\n \"identifier\": string\n },\n \"verificationMethod\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `site` | `object` | Container for the address and type of a site for which a verification token will be generated. | |\n| site.`type` | `string` | The type of resource to be verified. \u003cbr /\u003e Acceptable values are: - \"`ANDROID_APP`\" - \"`INET_DOMAIN`\" - \"`SITE`\" | |\n| 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. | |\n| `verificationMethod` | `string` | The verification method for the Site Verification system to use to verify this site or domain. \u003cbr /\u003e 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 | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"method\": string,\n \"token\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `method` | `string` | The verification method that you selected in the request. \u003cbr /\u003e Acceptable values are: - \"`ANALYTICS`\" - \"`DNS`\" - \"`DNS_CNAME`\" - \"`DNS_TXT`\" - \"`FILE`\" - \"`META`\" - \"`TAG_MANAGER`\" | |\n| `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](/site-verification/v1/getting_started#tokens) in the Getting Started document. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/siteVerification/v1/siteVerification.webResource.getToken)."]]