WebResource 表示经过验证的网站或域名。
其中包含网站或域名的规范 ID、网址或域名以及所有者列表。请注意,所有者列表始终包含经过身份验证的用户,因为只有可以访问该网站的用户是经过身份验证的用户,而这些用户是相应网站或网域的所有者。
有关此类资源的方法列表,请参阅本页面的结尾部分。
资源表示法
{ "id": string, "site": { "type": string, "identifier": string }, "owners": [ string ] }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
id |
string |
用于标识网站的字符串。此值应在 REST 网址的 id 部分用于 get、update 和 delete 操作。 | |
owners[] |
list |
此资源的所有经过验证的直接所有者的电子邮件地址。间接所有者(例如包含域名的经过验证的所有者)不在此列表中。 | |
site |
object |
已通过验证或将要验证的网站的地址和类型的容器。 | |
site.identifier |
string |
网站标识符,其形式不同,具体取决于 type 属性的值。 |
|
site.type |
string |
网站类型。
可接受的值:
|
方法
使用 insert 方法验证经过身份验证的用户对网站或网域的所有权。您可以使用 get、update、 和 delete 方法来检索或修改已经为经过身份验证的用户验证的资源。
您可以使用 list 查看已经过身份验证的用户的所有经过验证的资源,还可以使用 getToken 获取令牌并显示在经过身份验证的用户的网站上。