Method: accounts.homepage.claim

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

如果主页面已声明所有权，系统会重新检查验证（除非商家已免于声明所有权，这也免去了验证），并返回成功响应。如果无法再验证所有权，系统会返回错误，但不会清除版权主张。如果失败，系统会返回规范错误消息：* PERMISSION_DENIED：用户无权访问此 MC 账号；* 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 概览。