Method: accounts.homepage.claim

声明商店的首页。执行此方法需要管理员权限。

如果首页已声明所有权,此操作将重新检查验证状态(除非商家免于声明所有权,这也免于验证),并返回成功的响应。如果无法再验证所有权,则会返回错误,但不会清除版权主张。如果操作失败,系统会返回一条规范化错误消息:* PERMISSION_DENIED:用户没有对此 Merchant Center 账号的必要权限;* FAILED_PRECONDITION:- 该账号不是 Merchant Center 账号;- MC 账号没有首页;- 声明失败(在这种情况下,错误消息将包含更多详细信息)。

HTTP 请求

POST https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*/homepage}:claim

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要声明的首页的名称。格式:accounts/{account}/homepage

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "overwrite": boolean
}
字段
overwrite

boolean

可选。如果设为 true,此选项将移除所请求网站上现有的所有所有权声明,并将其替换为提出该请求的账号中的声明。

响应正文

如果成功,则响应正文包含一个 Homepage 实例。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/content

如需了解详情,请参阅 OAuth 2.0 概览