本文档将介绍如何使用 Google Site Verification API。
调用 API
请求格式
大多数受支持的网站验证操作都直接映射到 REST HTTP 动词(GET
、POST
、PUT
、DELETE
),如 Google Site Verification API 操作中所述。
Google Site Verification API URI 的具体格式为:
https://www.googleapis.com/siteVerification/v1/webResource/resourceID?parameters
其中 resourceID
是网络资源的标识符,parameters
是要应用于查询的任何参数。实际使用的参数因您所执行的操作而异。此外,如果您使用的是 OAuth 2.0,则应在这些参数中设置 access_token
。
列表查询不需要 resourceID,因此格式为:
https://www.googleapis.com/siteVerification/v1/webResource?parameters
您可以通过 getToken 操作的唯一 URI 来调用该操作。调用 getToken 的格式为:
https://www.googleapis.com/siteVerification/v1/token?parameters
数据格式
Google Site Verification API 会返回 JSON 格式的数据。
JSON(JavaScript 对象表示法)是一种与语言无关的常见数据格式,可通过简单的文本来表示任意数据结构。如需了解详情,请参阅 json.org。
操作摘要
您可以对 Google Site Verification API 中的集合和资源调用六种不同的方法,如下表所述。API 网址是相对于 https://www.googleapis.com/siteVerification/v1
而言的。
操作 | 说明 | 网址和语法 |
---|---|---|
list | 列出经过身份验证的用户集合中的所有资源。 |
请参阅示例 list 请求。 |
插入 | 验证网站或域名。如果成功,系统会将新的 Web 资源插入用户的集合中。 请求正文:请参阅网络资源。 查询参数: |
请参阅示例 insert 请求。 |
get | 获取特定网络资源的最新数据。 |
请参阅获取请求示例 |
update | 修改特定资源的所有者列表。 请求正文:请参阅网络资源。 注意:
|
请参阅更新请求示例。 |
delete | 从用户的集合中移除资源(验证网站属于该用户)。
|
请参阅删除请求示例。 |
getToken | 获取要通过身份验证的用户网站上的验证令牌。 请求正文:
|
请参阅示例 getToken 请求。 |
API 调用示例
此部分假定您(开发者)也是经过身份验证的用户,当您首次使用自己的测试数据试用该 API 时就属于这种情况。
验证新网站
要验证网站,请执行以下操作:
- 首先,通过调用 getToken 请求验证令牌。
- 使用您选择的任何方法将令牌放到您的网站上。
- 使用 insert 操作让 Google 验证网站归您所有。
getToken(需要授权)
POST https://www.googleapis.com/siteVerification/v1/token?access_token=
oauth2-token
请求:
POST https://www.googleapis.com/siteVerification/v1/token?access_token=oauth2-token
Content-Type: application/json
{
"verificationMethod": "FILE",
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
响应:
{ "token": "google12cfc68677988bb4.html", "method": "FILE" }
插入(需要授权)
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=
oauth2-token
请求:
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=oauth2-token
Content-Type: application/json
{
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
响应:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
检索经过验证的网络资源的信息
您可以调用 list 来检索经过验证的网站和网域的完整列表。您可以通过调用 get 来检索单个网络资源的信息。
列表(需要授权)
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=
oauth2-token
请求:
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=oauth2-token
响应:
{ "items": [ { "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/site1", "type": "SITE" } }, { "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/site2", "type": "SITE" } } ] }
Get(需要授权)
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
请求:
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
响应:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
修改验证信息
您可以通过调用 update 来委派和撤消所有权。您可以通过调用 delete 来移除自己的所有权。
更新(需要授权)
PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
请求:
PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Content-Type: application/json
{
"owners": [
"myself@example.com",
"another@example.com",
],
"id": "http%3A%2F%2Fwww.example.com%2F",
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
响应:
{ "owners": [ "myself@example.com", "another@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
删除(需要授权)
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
请求:
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
响应:
HTTP 204(无内容)状态代码,表示成功。