WebResource: getToken
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Autorisation requise
Récupère un jeton de validation à placer par l'utilisateur authentifié sur un site Web ou un domaine.
Essayer maintenant
Requête
Requête HTTP
POST https://www.googleapis.com/siteVerification/v1/token
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
| Champ d'application |
|---|
https://www.googleapis.com/auth/siteverification |
https://www.googleapis.com/auth/siteverification.verify_only |
Corps de la requête
Dans le corps de la requête, fournissez les données selon la structure suivante:
{
"site": {
"type": string,
"identifier": string
},
"verificationMethod": string
}
| Nom de propriété |
Valeur |
Description |
Remarques |
site |
object |
Conteneur pour l'adresse et le type d'un site pour lequel un jeton de validation sera généré. |
|
site.type |
string |
Type de ressource à vérifier.
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder"></ph>
- "
ANDROID_APP"
- "
INET_DOMAIN"
- "
SITE"
|
|
site.identifier |
string |
Identifiant du site. Si le type est défini sur SITE, l'identifiant est une URL. Si le type est défini sur INET_DOMAIN, l'identifiant est un nom de domaine. |
|
verificationMethod |
string |
Méthode utilisée par le système de validation du site pour valider ce site ou ce domaine.
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder"></ph>
- "
ANALYTICS" : sites uniquement
- "
DNS" : utilisez plutôt DNS_TXT.
- "
DNS_CNAME" : domaines uniquement
- "
DNS_TXT" : domaines uniquement
- "
FILE" : sites uniquement
- "
META" : sites uniquement
- "
TAG_MANAGER" : sites uniquement
|
|
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"method": string,
"token": string
}
| Nom de propriété |
Valeur |
Description |
Remarques |
method |
string |
Méthode de validation que vous avez sélectionnée dans la demande.
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder"></ph>
- "
ANALYTICS"
- "
DNS"
- "
DNS_CNAME"
- "
DNS_TXT"
- "
FILE"
- "
META"
- "
TAG_MANAGER"
|
|
token |
string |
Chaîne à placer sur le site de l'utilisateur authentifié, selon la méthode de validation sélectionnée. Pour en savoir plus, consultez la section Méthodes de validation et jetons dans le document de démarrage. |
|
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
Vous pouvez également essayer
autonome
un navigateur Web.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
