迁移首页设置

Merchant API 引入了专用 Homepage 资源。此资源提供了一些新方法来管理您的首页声明，并提供比经典版 Content API for Shopping 更强大的功能。

要使用网店功能，您需要完成两个步骤：先验证所有权，然后为您的账号声明网站。如需完成最后一步，请使用 accounts.homepage.claim。

主要区别

与 Content API for Shopping 相比，Merchant API 在首页方面做出了多项更改：

• 专用资源：Merchant API 提供了一个单独的 Homepage 资源 (accounts.homepage)，用于执行所有与首页相关的操作。（在 Content API for Shopping 中，您可以使用 accounts.claimwebsite 执行声明操作，首页网址 (website_url) 是 Account 资源的一部分，而声明状态 (website_claimed) 是 AccountStatus 资源的一部分。）
• 精细化方法：Merchant API 提供以下特定方法：
  • 检索首页详细信息：accounts.homepage.getHomepage
  • 更新首页 URI：accounts.homepage.updateHomepage
  • 声明首页：accounts.homepage.claim
  • 声明主页：accounts.homepage.unclaim Content API for Shopping 使用 accounts.claimwebsite 进行声明操作，accounts.update 设置网址（通过设置空网址来有效声明），以及 accounts.get/accountstatuses.get 分别检索网址和声明状态。
• 集中式信息：Merchant API Homepage 资源直接包含 uri（首页网址）和 claimed 状态。对 Homepage 资源进行操作的所有方法都会返回此资源，从而提供有关当前状态的即时反馈。在 Content API for Shopping 中，accounts.claimwebsite 不会返回更新后的状态，需要单独调用。
• 明确声明：在 Content API for Shopping 中，声明通常通过将 Account.website_url 更新为空字符串来实现。 商家 API 提供了一个专用方法 homepage.unclaim。
• 覆盖声明：在声明过程中，这两个 API 都支持 overwrite 参数，以便在可以验证所有权的情况下从其他账号接管声明。

请求

Merchant API 使用不同的 RESTful 端点来管理首页的不同方面。

请求说明	Content API for Shopping	Merchant API
获取首页详细信息	accounts.get（读作 Account.website_url），accountstatuses.get（读作 AccountStatus.website_claimed）	GET /accounts/v1/accounts/{account}/homepage
更新首页 URI	accounts.update（设置 Account.website_url）	PATCH /accounts/v1/accounts/{account}/homepage
声明首页所有权或重新验证首页	POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite（针对使用 accounts.update 设置的 Account.website_url采取了行动）	POST /accounts/v1/accounts/{account}/homepage:claim
免责声明首页	accounts.update（将 Account.website_url 设置为空字符串）	POST /accounts/v1/accounts/{account}/homepage:unclaim

标识符

Merchant API 中的资源标识已得到简化。

标识符说明	Content API for Shopping	Merchant API
用于资源访问的账号标识符	路径中的 merchantId（高级账号）和 accountId（子账号）	account（name 字段的一部分，例如 accounts/{account_id}/homepage）
首页资源标识符	不适用（隐式适用于 Account 资源）	name：accounts/{account_id}/homepage（用于标识 Homepage 子资源）

方法

Content API for Shopping 中侧重于声明操作的 accounts.claimwebsite 方法现在是 Merchant API 的 Homepage 资源中更广泛的功能集的一部分。

Content API for Shopping 方法	Merchant API 方法	适用范围和备注
accounts.claimwebsite	accounts.homepage.claim	直接发起或重新验证网站声明。对之前使用 homepage.update 设置的 uri 进行操作。包含 overwrite 参数。返回 Homepage 资源及其当前 uri 和 claimed 状态。
accounts.get（读作 Account.website_url），accountstatuses.get（读作 AccountStatus.website_claimed）	accounts.homepage.getHomepage	新增了专用方法，可通过一次调用检索当前首页 uri 及其 claimed 状态。
accounts.update（用于设置 Account.website_url）	accounts.homepage.updateHomepage	用于设置或更改首页的新专用方法 uri。
accounts.update（将 Account.website_url 设置为空字符串，作为取消声明的解决方法）	accounts.homepage.unclaim	新增了用于明确取消声明主页的专用方法。

详细的字段更改

首页信息的结构和访问方式发生了重大变化，逐渐转向 Merchant API 中的显式 Homepage 资源。

Content API for Shopping	Merchant API	说明
merchantId（accounts.claimwebsite 的路径参数）	name（Homepage 方法的路径参数，格式：accounts/{account}/homepage）	Merchant API 中 name 字符串的 account 部分对应于 Content API for Shopping 中的 accountId。
accountId（accounts.claimwebsite 的路径参数）	name（Homepage 方法的路径参数，格式：accounts/{account}/homepage）	正在管理的特定账号的主页的标识符。
overwrite（ContentAccountsClaimwebsiteRequest 正文和 AccountsCustomBatchRequestEntry 中的布尔值）	ClaimHomepageRequest.overwrite（homepage.claim 请求正文中的布尔值）	可选。如果 true 尝试声明网站，则可能会移除另一账号的现有声明（如果请求账号可以验证所有权）。
Account.website_url（Account 资源中的字段，使用 accounts.update 设置，使用 accounts.get 读取）	Homepage.uri（Homepage 资源中的字段）	商店首页的 URI (网址)。在 Merchant API 中，这是 Homepage 资源中的一个显式字段。它使用 accounts.homepage.updateHomepage 进行设置，并由所有 Homepage 方法返回。
AccountStatus.website_claimed（AccountStatus 资源中的字段，使用 accountstatuses.get 读取）	Homepage.claimed（Homepage 资源中的 output_only 布尔值字段）	指示 uri 是否已声明并经过验证。此状态直接显示在所有相关联的 Merchant API 方法返回的 Homepage 资源中。
不适用	UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage 请求正文参数）	homepage.update 的可选字段掩码，用于指定要返回哪些字段（例如，Homepage 资源的 uri 正在更新。