Une ressource WebResource est une représentation d'un site Web ou d'un domaine validé.
Il contient l'ID canonique d'un site ou d'un domaine, l'URL ou le nom de domaine et une liste de propriétaires. Notez que la liste des propriétaires inclut toujours l'utilisateur authentifié, car les seules personnes qui peuvent accéder à une ressource WebResource sont des utilisateurs authentifiés qui sont 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é | Value | 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 validés du domaine parent) ne sont pas inclus dans cette liste. | |
site |
object |
Conteneur pour l'adresse et le type d'un site validé ou qui sera validé. | |
site.identifier |
string |
Identifiant du site, qui se présente sous différentes formes selon la valeur de la propriété type . |
|
site.type |
string |
Type de site.
Les valeurs autorisées sont les suivantes :
|
Méthodes
La méthode insert permet de valider la propriété authentifiée d'un site Web ou d'un domaine. Utilisez les méthodes get, update, et delete pour récupérer ou modifier une ressource qui a déjà été validée pour l'utilisateur authentifié.
La liste list vous permet de voir toutes les ressources validées de l'utilisateur authentifié. Vous pouvez également obtenir un jeton à placer sur le site de l'utilisateur authentifié à l'aide de getToken.
- supprimer
- Annule la propriété d'un site Web ou d'un domaine.
- obtenir
- Récupère les données les plus récentes pour un site Web ou un domaine.
- getToken
- Récupère un jeton de validation que l'utilisateur authentifié doit placer sur un site Web ou un domaine.
- Insérer
- Vérifie la propriété d'un site Web ou d'un domaine.
- list
- Récupère la liste des sites Web et des domaines validés de l'utilisateur.
- mettre à jour
- Modifie la liste des propriétaires d'un site Web ou d'un domaine.