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 概览。