WebResource
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une ressource WebResource est une représentation d'un site Web ou d'un domaine validé.
Elle contient l'ID canonique d'un site ou d'un domaine, l'URL ou le nom du domaine, ainsi qu'une liste de propriétaires. Notez que la liste des propriétaires inclut toujours l'utilisateur authentifié, car les seuls utilisateurs ayant accès à une ressource WebResource sont les propriétaires de ce site ou de ce domaine.
La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}
| Nom de propriété |
Valeur |
Description |
Remarques |
id |
string |
Chaîne utilisée pour identifier ce site. Cette valeur doit être utilisée dans la partie id de l'URL REST pour les opérations get, update et delete. |
|
owners[] |
list |
Adresses e-mail de tous les propriétaires directs et validés de cette propriété exacte. Les propriétaires indirects (par exemple, les propriétaires confirmés du domaine parent) ne sont pas inclus dans cette liste. |
|
site |
object |
Conteneur pour l'adresse et le type d'un site qui est validé ou va être validé. |
|
site.identifier |
string |
L'identifiant du site, qui prend différentes formes en fonction de la valeur de la propriété type. |
|
site.type |
string |
Type de site.
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder"></ph>
ANDROID_APP : définissez identifier sur l'URL d'une application Android. Example: "android-app://com.google.android.youtube/"INET_DOMAIN : définissez identifier sur un nom de domaine. Exemples : "www.example.com", "example.com" ou "sous-domaine.example.com"SITE : définissez identifier sur une URL complète pour la racine de votre site, se terminant par le signe /. Examples: "https://www.example.com/" ou "https://www.example.com/sous-site/"
|
|
Méthodes
La méthode insert vous permet de valider la propriété d'un site Web ou d'un domaine par l'utilisateur authentifié. Utilisez les méthodes get, update, et delete afin de récupérer ou de modifier une ressource qui a déjà été validée pour l'utilisateur authentifié.
Vous pouvez afficher toutes les ressources validées pour l'utilisateur authentifié à l'aide de la commande list, et vous pouvez obtenir un jeton à placer sur le site de l'utilisateur authentifié à l'aide de getToken.
- supprimer
- Ce paramètre ne vérifie pas la propriété d'un site Web ou d'un domaine de l'utilisateur.
- get
- Récupère les données les plus récentes d'un site Web ou d'un domaine.
- getToken
- Récupère un jeton de validation à placer par l'utilisateur authentifié sur un site Web ou un domaine.
- insérer
- Vérifie la propriété d'un site Web ou d'un domaine.
- liste
- Récupère la liste des sites Web et domaines validés de l'utilisateur authentifié.
- mise à jour
- Modifie la liste des propriétaires d'un site Web ou d'un domaine.
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\u003eA WebResource represents a verified website or domain and includes its ID, URL/domain, and a list of owners, which always includes the authenticated user.\u003c/p\u003e\n"],["\u003cp\u003eYou can verify ownership, retrieve, update, and delete WebResources using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eWebResource data includes an ID, owner list, and site information containing the identifier and type (e.g., website, Android app, domain).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esite.identifier\u003c/code\u003e can be a domain name, a URL, or an Android app URL depending on the \u003ccode\u003esite.type\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSeveral methods are available to manage WebResources, including inserting (verifying ownership), retrieving data, updating owner lists, deleting, listing all verified resources, and getting a verification token.\u003c/p\u003e\n"]]],["A WebResource represents a verified website or domain, identified by an `id`, `site` (type and identifier), and a list of `owners`, which always includes the authenticated user. Key actions include using `insert` to verify ownership, `get`, `update`, and `delete` to manage existing resources, `list` to view verified sites, and `getToken` to obtain a verification token. Site `type` can be `ANDROID_APP`, `INET_DOMAIN`, or `SITE`, with corresponding identifier formats.\n"],null,["# WebResource\n\n\u003cbr /\u003e\n\nA WebResource is a representation of a verified website or domain.\n\n\u003cbr /\u003e\n\nIt contains the canonical ID of a site or domain, the URL or domain name, and a list of owners. Note that the owners list always includes the authenticated user, because the only people who can access a WebResource are authenticated users who are owners of that site or domain.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```carbon\n{\n \"id\": string,\n \"site\": {\n \"type\": string,\n \"identifier\": string\n },\n \"owners\": [\n string\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `id` | `string` | The string used to identify this site. This value should be used in the \u003cvar class=\"apiparam\" translate=\"no\"\u003eid\u003c/var\u003e portion of the REST URL for the [get](/site-verification/v1/webResource/get), [update](/site-verification/v1/webResource/update), and [delete](/site-verification/v1/webResource/delete) operations. | |\n| `owners[]` | `list` | The email addresses of all direct, verified owners of this exact property. Indirect owners---for example verified owners of the containing domain---are not included in this list. | |\n| `site` | `object` | Container for the address and type of a site that is verified or will be verified. | |\n| site.`identifier` | `string` | The site identifier, which takes different forms depending on the value of the `type` property. | |\n| site.`type` | `string` | The site type. \u003cbr /\u003e Acceptable values are: - \"`ANDROID_APP`\": Set `identifier` to an Android app URL. **Example:** \"android-app://com.google.android.youtube/\" - \"`INET_DOMAIN`\": Set `identifier` to a domain name. **Examples:** \"www.example.com\", \"example.com\" or \"subdomain.example.com\" - \"`SITE`\": Set `identifier` to a fully-qualified URL for your site root, ending in a / mark. **Examples:** \"https://www.example.com/\" or \"https://www.example.com/subsite/\" | |\n\nMethods\n-------\n\n\u003cbr /\u003e\n\nUse the [insert](/site-verification/v1/webResource/insert) method to verify the authenticated user's ownership of a website or domain. Use the [get](/site-verification/v1/webResource/get), [update](/site-verification/v1/webResource/update), and [delete](/site-verification/v1/webResource/delete) methods to retrieve or modify a resource that has already been verified for the authenticated user.\n\nYou can see all verified resources for the authenticated user with [list](/site-verification/v1/webResource/list), and you can get a token to place on the authenticated user's site with [getToken](/site-verification/v1/webResource/getToken).\n\n\u003cbr /\u003e\n\n[delete](/site-verification/v1/webResource/delete)\n: Unverifies the user's ownership of a website or domain.\n\n[get](/site-verification/v1/webResource/get)\n: Retrieves the most current data for a website or domain.\n\n[getToken](/site-verification/v1/webResource/getToken)\n: Gets a verification token for the authenticated user to place on a website or domain.\n\n[insert](/site-verification/v1/webResource/insert)\n: Verifies ownership of a website or domain.\n\n[list](/site-verification/v1/webResource/list)\n: Gets the list of the authenticated user's verified websites and domains.\n\n[update](/site-verification/v1/webResource/update)\n: Modifies the list of owners for a website or domain."]]
