Package google.shopping.merchant.accounts.v1beta

索引

• AccountIssueService（界面）
• AccountsService（界面）
• AutofeedSettingsService（界面）
• BusinessIdentityService（界面）
• BusinessInfoService（界面）
• EmailPreferencesService（界面）
• HomepageService（界面）
• OnlineReturnPolicyService（界面）
• ProgramsService（界面）
• RegionsService（界面）
• ShippingSettingsService（界面）
• TermsOfServiceAgreementStateService（界面）
• TermsOfServiceService（界面）
• UserService（界面）
• AcceptTermsOfServiceRequest（消息）
• Accepted（消息）
• AccessRight（枚举）
• Account（消息）
• AccountAggregation（消息）
• AccountIssue（消息）
• AccountIssue.ImpactedDestination（消息）
• AccountIssue.ImpactedDestination.Impact（消息）
• AccountIssue.Severity（枚举）
• Address（消息）
• AutofeedSettings（消息）
• BusinessDayConfig（消息）
• BusinessDayConfig.Weekday（枚举）
• BusinessIdentity（消息）
• BusinessIdentity.IdentityAttribute（消息）
• BusinessIdentity.IdentityAttribute.IdentityDeclaration（枚举）
• BusinessIdentity.PromotionsConsent（枚举）
• BusinessInfo（消息）
• CarrierRate（消息）
• ClaimHomepageRequest（消息）
• CreateAndConfigureAccountRequest（消息）
• CreateAndConfigureAccountRequest.AddAccountService（消息）
• CreateRegionRequest（消息）
• CreateUserRequest（消息）
• CustomerService（消息）
• CutoffTime（消息）
• DeleteAccountRequest（消息）
• DeleteRegionRequest（消息）
• DeleteUserRequest（消息）
• DeliveryTime（消息）
• DisableProgramRequest（消息）
• Distance（消息）
• Distance.Unit（枚举）
• EmailPreferences（消息）
• EmailPreferences.OptInState（枚举）
• EnableProgramRequest（消息）
• GetAccountRequest（消息）
• GetAutofeedSettingsRequest（消息）
• GetBusinessIdentityRequest（消息）
• GetBusinessInfoRequest（消息）
• GetEmailPreferencesRequest（消息）
• GetHomepageRequest（消息）
• GetOnlineReturnPolicyRequest（消息）
• GetProgramRequest（消息）
• GetRegionRequest（消息）
• GetShippingSettingsRequest（消息）
• GetTermsOfServiceAgreementStateRequest（消息）
• GetTermsOfServiceRequest（消息）
• GetUserRequest（消息）
• Headers（消息）
• Homepage（消息）
• InsertShippingSettingsRequest（消息）
• ListAccountIssuesRequest（消息）
• ListAccountIssuesResponse（消息）
• ListAccountsRequest（消息）
• ListAccountsResponse（消息）
• ListOnlineReturnPoliciesRequest（消息）
• ListOnlineReturnPoliciesResponse（消息）
• ListProgramsRequest（消息）
• ListProgramsResponse（消息）
• ListRegionsRequest（消息）
• ListRegionsResponse（消息）
• ListSubAccountsRequest（消息）
• ListSubAccountsResponse（消息）
• ListUsersRequest（消息）
• ListUsersResponse（消息）
• LocationIdSet（消息）
• MinimumOrderValueTable（消息）
• MinimumOrderValueTable.StoreCodeSetWithMov（消息）
• OnlineReturnPolicy（消息）
• OnlineReturnPolicy.ItemCondition（枚举）
• OnlineReturnPolicy.Policy（消息）
• OnlineReturnPolicy.Policy.Type（枚举）
• OnlineReturnPolicy.RestockingFee（消息）
• OnlineReturnPolicy.ReturnMethod（枚举）
• OnlineReturnPolicy.ReturnShippingFee（消息）
• OnlineReturnPolicy.ReturnShippingFee.Type（枚举）
• PhoneVerificationState（枚举）
• Program（消息）
• Program.Requirement（消息）
• Program.State（枚举）
• RateGroup（消息）
• Region（消息）
• Region.GeoTargetArea（消息）
• Region.PostalCodeArea（消息）
• Region.PostalCodeArea.PostalCodeRange（消息）
• Required（消息）
• RetrieveForApplicationTermsOfServiceAgreementStateRequest（消息）
• RetrieveLatestTermsOfServiceRequest（消息）
• Row（消息）
• Service（消息）
• Service.LoyaltyProgram（消息）
• Service.LoyaltyProgram.LoyaltyProgramTiers（消息）
• Service.ShipmentType（枚举）
• Service.StoreConfig（消息）
• Service.StoreConfig.CutoffConfig（消息）
• Service.StoreConfig.CutoffConfig.LocalCutoffTime（消息）
• Service.StoreConfig.StoreServiceType（枚举）
• ShippingSettings（消息）
• Table（消息）
• TermsOfService（消息）
• TermsOfServiceAgreementState（消息）
• TermsOfServiceKind（枚举）
• TransitTable（消息）
• TransitTable.TransitTimeRow（消息）
• TransitTable.TransitTimeRow.TransitTimeValue（消息）
• UnclaimHomepageRequest（消息）
• UpdateAccountRequest（消息）
• UpdateAutofeedSettingsRequest（消息）
• UpdateBusinessIdentityRequest（消息）
• UpdateBusinessInfoRequest（消息）
• UpdateEmailPreferencesRequest（消息）
• UpdateHomepageRequest（消息）
• UpdateRegionRequest（消息）
• UpdateUserRequest（消息）
• User（消息）
• User.State（枚举）
• Value（消息）
• Warehouse（消息）
• WarehouseBasedDeliveryTime（消息）
• WarehouseCutoffTime（消息）

AccountIssueService

用于支持 AccountIssueService API 的服务。

ListAccountIssues
rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse) 列出 Merchant Center 账号的所有账号问题。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

AccountsService

用于支持 Accounts API 的服务。

CreateAndConfigureAccount
rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account) 创建具有额外配置的独立 Merchant Center 账号。将发出请求的用户添加为新账号的管理员。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

DeleteAccount
rpc DeleteAccount(DeleteAccountRequest) returns (Empty) 删除指定的账号，无论其类型为何（独立账号、MCA 账号或子账号）。删除 MCA 会导致其所有子账号一并被删除。执行此方法需要管理员权限。只有当该账号不向任何其他账号提供服务且没有处理过的商品时，删除才会成功。您可以使用 force 参数替换此设置。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

GetAccount
rpc GetAccount(GetAccountRequest) returns (Account) 从您的 Merchant Center 账号检索账号。插入、更新或删除账号后，所做更改可能需要几分钟才能生效。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ListAccounts
rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse) 列出可供发起调用的用户访问且与请求的约束条件（例如页面大小或过滤条件）匹配的账号。这不仅会列出 MCA 的子账号，还会列出发起调用的用户有权访问的所有账号，包括其他 MCA、关联的账号、独立账号等。如果未提供过滤条件，则会返回用户直接添加到其中的账号。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ListSubAccounts
rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse) 列出指定多客户账号的所有子账号。这是更强大的 ListAccounts 方法的便捷封装容器。此方法将产生与使用以下过滤条件调用 ListsAccounts 相同的结果：relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION")) 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateAccount
rpc UpdateAccount(UpdateAccountRequest) returns (Account) 更新账号，无论其类型为何（独立账号、MCA 账号或子账号）。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

AutofeedSettingsService

用于支持自动 Feed 设置的服务。

GetAutofeedSettings
rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings) 检索账号的自动 Feed 设置。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateAutofeedSettings
rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings) 更新账号的自动 Feed 设置。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

BusinessIdentityService

用于支持 business identity API 的服务。

GetBusinessIdentity
rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity) 检索账号的商家身份。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateBusinessIdentity
rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity) 更新账号的商家身份。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

BusinessInfoService

用于支持商家信息 API 的服务。

GetBusinessInfo
rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo) 检索账号的商家信息。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateBusinessInfo
rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo) 更新账号的商家信息。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

EmailPreferencesService

用于支持 EmailPreferences API 的服务。

GetEmailPreferences
rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences) 返回 Merchant Center 账号用户的电子邮件接收设置。此服务仅允许检索和更新经过身份验证的用户的电子邮件偏好设置。使用 name=accounts/*/users/me/emailPreferences 别名可获取已验证用户的偏好设置。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateEmailPreferences
rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences) 更新 Merchant Center 账号用户的电子邮件接收设置。MCA 用户应指定 MCA 账号，而不是 MCA 的子账号。 未在更新掩码中明确选择的偏好设置将不会更新。 更新不得指定“未确认”的用户选择接受状态值。 使用 name=accounts/*/users/me/emailPreferences 别名更新经过身份验证的用户的偏好设置。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

HomepageService

用于为商店首页支持 API 的服务。

ClaimHomepage
rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage) 声明商店的首页。执行此方法需要管理员权限。 如果主页面已声明所有权，系统会重新检查验证（除非商家已免于声明所有权，这也免去了验证），并返回成功响应。如果无法再验证所有权，系统会返回错误，但不会清除版权主张。如果失败，系统会返回规范错误消息：* PERMISSION_DENIED：用户无权访问此 MC 账号；* FAILED_PRECONDITION：- 该账号不是 Merchant Center 账号；- MC 账号没有首页；- 声明失败（在这种情况下，错误消息将包含更多详细信息）。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

GetHomepage
rpc GetHomepage(GetHomepageRequest) returns (Homepage) 检索商店的首页。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UnclaimHomepage
rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage) 取消声明商店的首页。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateHomepage
rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage) 更新商店的首页。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

OnlineReturnPolicyService

该服务有助于管理商家因买家反悔而退货的退货政策配置，涵盖适用于广告和非付费商品详情的退货政策

计划。此 API 定义了以下资源模型：

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy
rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy) 获取指定商家的现有退货政策。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ListOnlineReturnPolicies
rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse) 列出指定商家的所有现有退货政策。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ProgramsService

用于管理计划的服务。

计划提供了一种向商家账号添加功能的机制。一个典型的例子就是非付费商品详情计划，该计划可让商家在 Google 各平台上免费展示其商店中的商品。

除了用于明确启用或停用参与各个计划的方法之外，此服务还公开了用于检索商家参与的所有可用计划的方法。

DisableProgram
rpc DisableProgram(DisableProgramRequest) returns (Program) 禁止账号参与指定计划。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

EnableProgram
rpc EnableProgram(EnableProgramRequest) returns (Program) 为账号启用参与指定计划的权限。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

GetProgram
rpc GetProgram(GetProgramRequest) returns (Program) 检索账号的指定计划。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ListPrograms
rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse) 检索账号的所有计划。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

RegionsService

管理地区配置。

此 API 定义了以下资源模型：

• Region

CreateRegion
rpc CreateRegion(CreateRegionRequest) returns (Region) 在您的 Merchant Center 账号中创建地区定义。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

DeleteRegion
rpc DeleteRegion(DeleteRegionRequest) returns (Empty) 从您的 Merchant Center 账号中删除地区定义。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

GetRegion
rpc GetRegion(GetRegionRequest) returns (Region) 检索 Merchant Center 账号中定义的地区。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ListRegions
rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse) 列出 Merchant Center 账号中的地区。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateRegion
rpc UpdateRegion(UpdateRegionRequest) returns (Region) 更新 Merchant Center 账号中的地区定义。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ShippingSettingsService

用于按 Merchant API 方法获取方法调用配送设置信息的服务。

GetShippingSettings
rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings) 检索配送设置信息。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

InsertShippingSettings
rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings) 将商家的配送设置替换为“请求配送”设置。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

TermsOfServiceAgreementStateService

用于支持 TermsOfServiceAgreementState API 的服务。

GetTermsOfServiceAgreementState
rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState) 返回服务条款协议的状态。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

RetrieveForApplicationTermsOfServiceAgreementState
rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState) 检索应用服务条款的协议状态。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

TermsOfServiceService

用于支持 TermsOfService API 的服务。

AcceptTermsOfService
rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty) 接受 TermsOfService。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

GetTermsOfService
rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService) 检索与所提供的版本关联的 TermsOfService。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

RetrieveLatestTermsOfService
rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService) 检索给定 kind 和 region_code 的最新版 TermsOfService。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UserService

用于支持用户 API 的服务。

CreateUser
rpc CreateUser(CreateUserRequest) returns (User) 创建 Merchant Center 账号用户。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

DeleteUser
rpc DeleteUser(DeleteUserRequest) returns (Empty) 删除 Merchant Center 账号用户。执行此方法需要管理员权限。要删除的用户不能是该账号的最后一位管理员用户。此外，如果用户由商家管理工具管理，则不会被删除” 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

GetUser
rpc GetUser(GetUserRequest) returns (User) 检索 Merchant Center 账号用户。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ListUsers
rpc ListUsers(ListUsersRequest) returns (ListUsersResponse) 列出 Merchant Center 账号的所有用户。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

UpdateUser
rpc UpdateUser(UpdateUserRequest) returns (User) 更新 Merchant Center 账号用户。执行此方法需要管理员权限。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

AcceptTermsOfServiceRequest

对 AcceptTermsOfService 方法的请求消息。

字段
name	string 必需。服务条款版本的资源名称。格式：termsOfService/{version}
account	string 必需。要接受服务条款的账号。
region_code	string 必需。由 CLDR 定义的地区代码。如果服务条款仅适用于某个国家/地区，则此字段应填写相应国家/地区的代码；如果服务条款适用于全球，则应填写 001。

已接受

说明已接受的服务条款。

字段
terms_of_service	string 已接受的termsOfService。
accepted_by	string 记录接受情况的账号。这可以是账号本身，也可以是子账号的 MCA 账号。
valid_until	Date 设置此属性后，系统会指明已接受的TermsOfService仅在该日期结束之前有效（以 UTC 时间为准）。您必须在该日期之前接受新的合作伙伴协议。您可以在必需消息中找到必需的 TermsOfService 信息。

AccessRight

访问权限。

枚举
ACCESS_RIGHT_UNSPECIFIED	默认值。此值未使用。
STANDARD	标准访问权限。
ADMIN	管理员访问权限。
PERFORMANCE_REPORTING	拥有此权限的用户可以访问效果和数据洞见。

账号

Account 消息代表商家在购物广告中的账号。它是管理商品数据、设置以及与 Google 服务和外部提供商的互动的主要实体。

账号可以作为独立实体运行，也可以是多客户账号 (MCA) 结构的一部分。在 MCA 设置中，父级账号管理多个子账号。

创建账号需要配置账号名称、时区和语言偏好设置等属性。

Account 消息是许多其他资源（例如 AccountRelationship、Homepage、BusinessInfo 等）的父级实体。

字段
name	string 标识符。账号的资源名称。格式：accounts/{account}
account_id	int64 仅限输出。账号的 ID。
account_name	string 必需。账号的简单易懂的名称。如需了解详情，请参阅商店名称和商家名称。
adult_content	bool 此账号是否包含成人内容。
test_account	bool 仅限输出。此账号是否为测试账号。
time_zone	TimeZone 必需。账户的时区。 在写入时，time_zone 会同时设置 reporting_time_zone 和 display_time_zone。 对于读取操作，time_zone 始终返回 display_time_zone。如果您的账号不存在 display_time_zone，time_zone 会为空。
language_code	string 必需。账号的 BCP-47 语言代码，例如 en-US 或 sr-Latn。

AccountAggregation

此类型没有字段。

AccountAggregation 载荷。

AccountIssue

一个 AccountIssue。

字段
name	string 标识符。账号问题的资源名称。格式：accounts/{account}/issues/{id}
title	string 问题的本地化标题。
severity	Severity 问题的总体严重程度。
impacted_destinations[]	ImpactedDestination 此问题对各种目标平台的影响。
detail	string 有关该问题的更多本地化详细信息。
documentation_uri	string 指向 Merchant Center 帮助中心的链接，其中详细介绍了该问题以及解决方法。

ImpactedDestination

问题对目标平台的影响。

字段
impacts[]	Impact 给定目标平台在不同地区的负面影响。
reporting_context	ReportingContextEnum 受影响的报告上下文。

影响

问题对某个区域的影响。

字段
region_code	string 此问题适用的 CLDR 地区代码。
severity	Severity 问题在目标平台和地区的严重程度。

严重程度

所有可能的问题严重程度。

枚举
SEVERITY_UNSPECIFIED	严重程度未知。
CRITICAL	此问题会导致商品无法投放。
ERROR	此问题可能会影响商品（未来），也可能表明商品存在问题。
SUGGESTION	此问题是指改进建议。

地址

仓库的送货地址。

字段
street_address	string 地址的街道级部分。例如：111w 31st Street。
city	string 必需。城市、镇或公社。还可以包括乡镇/郊区或子级市行政区（例如街区或郊区）。
administrative_area	string 必需。国家/地区的顶级行政区划。例如，加利福尼亚州（“CA”）或魁北克省（“QC”）等州/省。
postal_code	string 必需。邮政编码（例如“94043”）。
region_code	string 必需。CLDR 国家/地区代码（例如“US”）。

AutofeedSettings

与自动 Feed 设置相关的信息集合。

字段
name	string 标识符。自动 Feed 设置的资源名称。格式：accounts/{account}/autofeedSettings。
enable_products	bool 必需。为指定账号启用或停用通过自动 Feed 抓取商品的功能。自动 Feed 账号必须满足特定条件，您可以通过 eligible 字段查看这些条件。该账号不得是购物平台。首次启用自动 Feed 后，商品通常会立即显示。重新启用后，商品最长可能需要 24 小时才会显示。
eligible	bool 仅限输出。确定商家是否符合使用自动 Feed 的条件。

BusinessDayConfig

仓库的工作日。

字段
business_days[]	Weekday 必需。正常工作日。不得为空。

星期几

枚举
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

与商家身份相关的信息集合。

字段
name	string 标识符。商家身份的资源名称。格式：accounts/{account}/businessIdentity
promotions_consent	PromotionsConsent 必需。身份属性是否可用于促销活动。
black_owned	IdentityAttribute 可选。指定商家是否自称是黑人经营的商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。
women_owned	IdentityAttribute 可选。指定商家是否自称是女性经营的商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。
veteran_owned	IdentityAttribute 可选。指定商家是否将自己标识为退伍军人经营的商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。
latino_owned	IdentityAttribute 可选。指定商家是否自称是拉丁裔所有。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。
small_business	IdentityAttribute 可选。指定商家是否将自己标识为小型商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台。

IdentityAttribute

与身份属性相关的所有信息。

字段
identity_declaration	IdentityDeclaration 必需。此属性的身份声明。

IdentityDeclaration

与声明身份相关的所有可能设置。

枚举
IDENTITY_DECLARATION_UNSPECIFIED	默认值，表示未进行任何选择。
SELF_IDENTIFIES_AS	表示账号使用该属性进行标识。
DOES_NOT_SELF_IDENTIFY_AS	表示账号不具有该属性。

PromotionsConsent

与商家身份相关的所有可能的促销活动设置。

枚举
PROMOTIONS_CONSENT_UNSPECIFIED	默认值，表示未进行任何选择。
PROMOTIONS_CONSENT_GIVEN	表示该账号同意将其商家身份用于宣传目的。
PROMOTIONS_CONSENT_DENIED	表示该账号不同意将其企业身份用于宣传目的。

BusinessInfo

BusinessInfo 消息包含有关商家业务的重要信息。

此消息会捕获商家的主要详细信息，例如实际地址、客户服务联系信息和地区专用标识符。

字段
name	string 标识符。商家信息的资源名称。格式：accounts/{account}/businessInfo
address	PostalAddress 可选。商家的地址。仅支持 region_code、address_lines、postal_code、administrative_area 和 locality 字段。系统会忽略所有其他字段。
phone	PhoneNumber 仅限输出。商家的电话号码。
phone_verification_state	PhoneVerificationState 仅限输出。商家的电话验证状态。
customer_service	CustomerService 可选。商家的客户服务。
korean_business_registration_number	string 可选。10 位数的韩国企业注册号，以英文短划线分隔，格式为 XXX-XX-XXXXX。

CarrierRate

可由 main_table 或 single_value 引用的运营商费率列表。https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only 中列出了受支持的快递公司服务。

字段
name	string 必需。运营商费率的名称。每个费率组的编号必须是唯一的。
carrier	string 必需。运营商服务，例如 "UPS" 或 "Fedex"。
carrier_service	string 必需。运营商服务，例如 "ground" 或 "2 days"。
origin_postal_code	string 必需。此运输公司费率的配送起点。
percentage_adjustment	string 可选。以十进制表示的乘法配送费率修饰符。可以为负数。例如，"5.4" 会将费率提高 5.4%，"-3" 会将费率降低 3%。
flat_adjustment	Price 可选。加法运费修饰符。可以为负数。例如，{ "amount_micros": 1, "currency_code" : "USD" } 会将费率增加 1 美元，{ "amount_micros": -3, "currency_code" : "USD" } 会将费率减少 3 美元。

ClaimHomepageRequest

对 ClaimHomepage 方法的请求消息。

字段
name	string 必需。要声明的首页的名称。格式：accounts/{account}/homepage
overwrite	bool 可选。将此选项设置为 true 后，系统会移除所请求网站上的所有现有版权主张，并将其替换为发出请求的账号的版权主张。

CreateAndConfigureAccountRequest

对 CreateAndConfigureAccount 方法的请求消息。

字段
account	Account 必需。要创建的账号。
users[]	CreateUserRequest 可选。要添加到账号的用户。
service[]	AddAccountService 必需。在创建过程中，系统会初始化要创建的账号与提供方账号之间的账号服务。需要提供至少一项此类服务。目前，其中必须有一个是 account_aggregation，这意味着您只能通过此方法创建子账号，而不能创建独立账号。可能会提供额外的 account_management 或 product_management 服务。

AddAccountService

有关在创建账号时添加账号服务的其他说明。

字段
联合字段 service_type。要添加的服务类型。service_type 只能是下列其中一项：
account_aggregation	AccountAggregation 提供商是该账号的聚合信息网站。服务类型为“账号汇总”的载荷。
provider	string 必需。服务的提供商。格式：accounts/{account}

CreateRegionRequest

对 CreateRegion 方法的请求消息。

字段
parent	string 必需。要为其创建地区的账号。格式：accounts/{account}
region_id	string 必需。地区的标识符，在同一账号的所有地区中是唯一的。
region	Region 必需。要创建的区域。

CreateUserRequest

对 CreateUser 方法的请求消息。

字段
parent	string 必需。要为其创建用户的账号的资源名称。格式：accounts/{account}
user_id	string 必需。用户的电子邮件地址（例如 [e-mail]）。
user	User 必需。要创建的用户。

CustomerService

客户服务信息。

字段
uri	string 可选。用于查找客户服务的 URI。
email	string 可选。可联系客户服务的电子邮件地址。
phone	PhoneNumber 可选。可拨打的客户服务电话号码。

CutoffTime

工作日截止时间定义。

字段
hour	int32 必需。截止时间（下单截止时间），订单必须在此之前下单，才能在当天处理。
minute	int32 必需。截止时间的分钟数，订单必须在此时间之前下单，才能在当天处理。
time_zone	string 必需。时区标识符，例如“Europe/Zurich”。

DeleteAccountRequest

对 DeleteAccount 方法的请求消息。

字段
name	string 必需。要删除的账号的名称。格式：accounts/{account}
force	bool 可选。如果设置为 true，系统会删除该账号，即使该账号向其他账号提供服务或处理了商品交易也是如此。

DeleteRegionRequest

对 DeleteRegion 方法的请求消息。

字段
name	string 必需。要删除的地区的名称。格式：accounts/{account}/regions/{region}

DeleteUserRequest

对 DeleteUser 方法的请求消息。

字段
name	string 必需。要删除的用户的名称。格式：accounts/{account}/users/{email} 您还可以使用 me（而不是 accounts/{account}/users/me 中的电子邮件地址）删除与调用方对应的用户。

DeliveryTime

从下单到商品送达所花费的各个方面时间。

字段
warehouse_based_delivery_times[]	WarehouseBasedDeliveryTime 可选。表示应根据所选运输公司的设置，按仓库（发货地点）计算送货时间。设置此字段后，[送货时间][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]] 中的任何其他与运送时间相关的字段都不应设置。
min_transit_days	int32 商品在运输过程中所需的最短工作日数。0 表示当天送达，1 表示次日送达。必须设置 min_transit_days、max_transit_days 或 transit_time_table，但不能同时设置这两者。
max_transit_days	int32 运送所需的最长工作日数。0 表示当天送达，1 表示次日送达。必须大于或等于 min_transit_days。
cutoff_time	CutoffTime 工作日截止时间定义。如果未配置，截止时间将默认为太平洋标准时间上午 8:00。
min_handling_days	int32 订单发货前所需的最短工作日天数。0 表示当天发货，1 表示次日发货。“min_handling_days”和“max_handling_days”应同时设置或同时不设置。
max_handling_days	int32 订单发货前所需的最长工作日天数。0 表示当天发货，1 表示次日发货。必须大于或等于 min_handling_days。“min_handling_days”和“max_handling_days”应同时设置或同时不设置。
transit_time_table	TransitTable 运送时间表，根据行和列维度显示运送所需的工作日数。您可以设置 min_transit_days、max_transit_days 或 transit_time_table，但不能同时设置这两者。
handling_business_day_config	BusinessDayConfig 可以处理订单的工作日。如果未提供，系统会假定为周一至周五的工作日。
transit_business_day_config	BusinessDayConfig 订单在运输过程中所需的工作日数。如果未提供，系统会假定为周一至周五的工作日。

DisableProgramRequest

针对 DisableProgram 方法的请求消息。

字段
name	string 必需。要为指定账号停用参与的计划的名称。格式：accounts/{account}/programs/{program}

距离

最大配送半径。只有本地配送配送类型才需要此属性。

字段
value	int64 距离的整数值。
unit	Unit 单位可能会因国家/地区而异，其参数包括英里和公里。

单位

单位可能会因国家/地区而异，其参数包括英里和公里。

枚举
UNIT_UNSPECIFIED	未指定单位
MILES	单位为英里
KILOMETERS	单位为公里

EmailPreferences

用户选择接收 / 选择停止接收的通知类别。电子邮件偏好设置不包括用户无法选择停收的重要通知。

字段
name	string 标识符。EmailPreferences 的名称。此端点仅适用于经过身份验证的用户。
news_and_tips	OptInState 可选。有关新功能、提示和最佳实践的最新动态。

OptInState

电子邮件接收设置的“选择接收”状态。

枚举
OPT_IN_STATE_UNSPECIFIED	未指定用户选择接受的状态。
OPTED_OUT	用户已选择不接收此类电子邮件。
OPTED_IN	用户已选择接收此类电子邮件。
UNCONFIRMED	用户已选择接收此类电子邮件，系统已发送确认电子邮件，但用户尚未确认选择接收（仅适用于某些国家/地区）。

EnableProgramRequest

针对 EnableProgram 方法的请求消息。

字段
name	string 必需。要为指定账号启用参与的计划的名称。格式：accounts/{account}/programs/{program}

GetAccountRequest

对 GetAccount 方法的请求消息。

字段
name	string 必需。要检索的账号的名称。格式：accounts/{account}

GetAutofeedSettingsRequest

对 GetAutofeedSettings 方法的请求消息。

字段
name	string 必需。自动 Feed 设置的资源名称。格式：accounts/{account}/autofeedSettings

GetBusinessIdentityRequest

对 GetBusinessIdentity 方法的请求消息。

字段
name	string 必需。商家身份的资源名称。格式：accounts/{account}/businessIdentity

GetBusinessInfoRequest

对 GetBusinessInfo 方法的请求消息。

字段
name	string 必需。商家信息的资源名称。格式：accounts/{account}/businessInfo

GetEmailPreferencesRequest

GetEmailPreferences 方法的请求消息。

字段
name	string 必需。EmailPreferences 资源的名称。格式：accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

对 GetHomepage 方法的请求消息。

字段
name	string 必需。要检索的主页的名称。格式：accounts/{account}/homepage

GetOnlineReturnPolicyRequest

对 GetOnlineReturnPolicy 方法的请求消息。

字段
name	string 必需。要检索的退货政策的名称。格式：accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

GetProgram 方法的请求消息。

字段
name	string 必需。要检索的计划的名称。格式：accounts/{account}/programs/{program}

GetRegionRequest

对 GetRegion 方法的请求消息。

字段
name	string 必需。要检索的地区的名称。格式：accounts/{account}/regions/{region}

GetShippingSettingsRequest

对 GetShippingSetting 方法的请求消息。

字段
name	string 必需。要检索的配送设置的名称。格式：accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

对 GetTermsOfServiceAgreementState 方法的请求消息。

字段
name	string 必需。服务条款版本的资源名称。格式：accounts/{account}/termsOfServiceAgreementState/{identifier}。标识符格式为：{TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

对 GetTermsOfService 方法的请求消息。

字段
name	string 必需。服务条款版本的资源名称。格式：termsOfService/{version}

GetUserRequest

对 GetUser 方法的请求消息。

字段
name	string 必需。要检索的用户的名称。格式：accounts/{account}/users/{email} 您还可以使用 me（而不是 accounts/{account}/users/me 中的电子邮件地址）检索与调用方对应的用户。

标头

表格的行或列标题的非空列表。必须设置 prices、weights、num_items、postal_code_group_names 或 location 中的一个。

字段
prices[]	Price 必需。包含上限的订单价格上限列表。通过将价格 amount_micros 设置为 -1，可以将最后一个价格的值设为无穷大。例如，[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] 表示标头“<= $10”“<= $500”和“> $500”。同一服务中的所有价格都必须采用相同的币种。不得为空。必须为正值（-1 除外）。只有在未设置所有其他字段的情况下才能设置此字段。
weights[]	Weight 必需。包含上限的订单重量上限列表。通过将价格 amount_micros 设置为 -1，可以将最后一个权重的值设为无穷大。例如，[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] 表示标题“<= 10kg”“<= 50kg”和“> 50kg”。服务中的所有权重都必须使用相同的单位。不得为空。必须为正值（-1 除外）。只有在未设置所有其他字段的情况下才能设置此字段。
number_of_items[]	string 必需。包含商品数量上限（包括该数值）的列表。最后一个值可以是 "infinity"。例如，["10", "50", "infinity"] 表示标题“<= 10 项”“<= 50 项”和“> 50 项”。不得为空。只有在未设置所有其他字段的情况下才能设置此字段。
postal_code_group_names[]	string 必需。邮政组名称列表。最后一个值可以是 "all other locations"。示例：["zone 1", "zone 2", "all other locations"]。提及的邮政编码组必须与服务的送货国家/地区一致。不得为空。只有在未设置所有其他字段的情况下才能设置此字段。
locations[]	LocationIdSet 必需。位置 ID 集的列表。不得为空。只有在未设置所有其他字段的情况下才能设置此字段。

首页

Homepage 消息代表商家在系统中的商店首页。

商家的首页是客户与其商店互动的主要网域。

商家可以声明并验证首页以证明其所有权，从而解锁需要经过验证的网站才能使用的功能。如需了解详情，请参阅了解网店网址验证。

字段
name	string 标识符。商店首页的资源名称。格式：accounts/{account}/homepage
claimed	bool 仅限输出。首页是否已声明所有权。请参阅 https://support.google.com/merchants/answer/176793。
uri	string 必需。商店首页的 URI（通常是网址）。

InsertShippingSettingsRequest

对 InsertShippingSetting 方法的请求消息。

字段
parent	string 必需。要插入此商品的账号。格式：accounts/{account}
shipping_setting	ShippingSettings 必需。新版账号。

ListAccountIssuesRequest

对 ListAccountIssues 方法的请求消息。

字段
parent	string 必需。拥有此问题集合的父级。格式：accounts/{account}
page_size	int32 可选。要返回的最大问题数。服务返回的值可能小于此值。如果未指定，则最多返回 50 位用户。最大值为 100；高于 100 的值将强制转换为 100
page_token	string 可选。从之前的 ListAccountIssues 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListAccountIssues 的所有其他参数必须与提供页面令牌的调用匹配。
language_code	string 可选。响应中的错误将包含以指定语言提供的直观易懂的字段。格式为 BCP-47，例如 en-US 或 sr-Latn。如果未提供任何值，系统将使用 en-US。
time_zone	string 可选。用于在人类可读字段中本地化时间的 IANA 时区。例如“America/Los_Angeles”。如果未设置，则使用“America/Los_Angeles”。

ListAccountIssuesResponse

ListAccountIssues 方法的响应消息。

字段
account_issues[]	AccountIssue 指定账号存在的问题。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListAccountsRequest

对 ListAccounts 方法的请求消息。

字段
page_size	int32 可选。要返回的账号数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 250 个账号。最大值为 500；大于 500 的值将被强制转换为 500。
page_token	string 可选。从之前的 ListAccounts 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListAccounts 的所有其他参数必须与提供页面令牌的调用匹配。
filter	string 可选。仅返回与过滤条件匹配的账号。如需了解详情，请参阅过滤条件语法参考文档。

ListAccountsResponse

ListAccounts 方法的响应消息。

字段
accounts[]	Account 与 ListAccountsRequest 匹配的账号。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListOnlineReturnPoliciesRequest

对 ListOnlineReturnPolicies 方法的请求消息。

字段
parent	string 必需。需要列出其退货政策的商家账号。格式：accounts/{account}
page_size	int32 可选。要返回的 OnlineReturnPolicy 资源数上限。如果给定商家的退货政策数量少于 pageSize，则该服务返回的数量会少于此值。默认值为 10。最大值为 100；如果指定的值高于上限，则 pageSize 将默认为上限
page_token	string 可选。从之前的 ListOnlineReturnPolicies 调用接收的页面令牌。提供页面令牌以检索后续页面。 进行分页时，提供给 ListOnlineReturnPolicies 的所有其他参数必须与提供页面令牌的调用相一致。在对上一个请求的响应中作为 nextPageToken 返回的令牌。

ListOnlineReturnPoliciesResponse

ListOnlineReturnPolicies 方法的响应消息。

字段
online_return_policies[]	OnlineReturnPolicy 检索到的退货政策。
next_page_token	string 可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListProgramsRequest

ListPrograms 方法的请求消息。

字段
parent	string 必需。要检索其所有计划的账号的名称。格式：accounts/{account}
page_size	int32 可选。单个响应中可返回的节目数量上限。如果未指定（或 0），则使用默认大小 1000。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
page_token	string 可选。从之前的 ListPrograms 调用接收的续订令牌。提供此令牌以检索下一页。

ListProgramsResponse

ListPrograms 方法的响应消息。

字段
programs[]	Program 指定账号的计划。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListRegionsRequest

对 ListRegions 方法的请求消息。

字段
parent	string 必需。要列出其地区的账号。格式：accounts/{account}
page_size	int32 可选。要返回的区域数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个区域。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
page_token	string 可选。从之前的 ListRegions 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListRegions 的所有其他参数必须与提供页面令牌的调用匹配。

ListRegionsResponse

ListRegions 方法的响应消息。

字段
regions[]	Region 指定商家的地区。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListSubAccountsRequest

对 ListSubAccounts 方法的请求消息。

字段
provider	string 必需。家长账号。格式：accounts/{account}
page_size	int32 可选。要返回的账号数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 250 个账号。最大值为 500；大于 500 的值将被强制转换为 500。
page_token	string 可选。从之前的 ListAccounts 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListAccounts 的所有其他参数必须与提供页面令牌的调用匹配。

ListSubAccountsResponse

ListSubAccounts 方法的响应消息。

字段
accounts[]	Account 指定父级账号是汇总账号的账号。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListUsersRequest

对 ListUsers 方法的请求消息。

字段
parent	string 必需。拥有此用户集合的父级。格式：accounts/{account}
page_size	int32 可选。要返回的用户数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 位用户。最大值为 100；高于 100 的值将强制转换为 100
page_token	string 可选。从之前的 ListUsers 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListUsers 的所有其他参数必须与提供页面令牌的调用匹配。

ListUsersResponse

ListUsers 方法的响应消息。

字段
users[]	User 指定账号中的用户。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

LocationIdSet

位置 ID 集的列表。不得为空。只有在未设置所有其他字段的情况下才能设置此字段。

字段
location_ids[]	string 必需。地理位置 ID 的非空列表。它们必须都属于同一地理位置类型（例如州）。

MinimumOrderValueTable

自提履单类型的每家商店最低订单金额表。

字段
store_code_set_with_movs[]	StoreCodeSetWithMov 必需。共享相同最低订单金额 (MOV) 的商店代码集列表。至少需要两个集，并且最后一个集必须为空，表示“MOV for all other stores”（适用于所有其他商店）。每个商店代码在所有组中只能出现一次。同一服务中的所有价格都必须采用相同的币种。

StoreCodeSetWithMov

共享相同最低订单金额的商店代码集的列表。至少需要两个集，并且最后一个集必须为空，表示“MOV for all other stores”（适用于所有其他商店）。每个商店代码在所有组中只能出现一次。同一服务中的所有价格都必须采用相同的币种。

字段
store_codes[]	string 可选。唯一商店代码的列表，如果是全局性代码，则为空。
value	Price 指定商店的最低订单金额。

OnlineReturnPolicy

在线退货政策对象。此属性目前用于表示广告和非付费商品详情计划的退货政策。

字段
name	string 标识符。OnlineReturnPolicy 资源的名称。格式：accounts/{account}/onlineReturnPolicies/{return_policy}
return_policy_id	string 仅限输出。Google 生成的退货政策 ID。
label	string 必需。此字段表示退货政策的用户定义的唯一标签。请务必注意，同一国家/地区的不同退货政策不能使用相同的标签。除非商品指定了特定的标签属性，否则系统会自动将政策标记为“默认”。如需为特定商品组分配自定义退货政策，请按照退货政策标签中提供的说明操作。标签最多可包含 50 个字符。
countries[]	string 必需。退货政策适用的销售国家/地区。值必须是有效的 2 个字母 ISO 3166 代码。
policy	Policy 退货政策。
restocking_fee	RestockingFee 适用于所有退货原因类别的重新上架费。如果未设置此值，系统会将其视为免费的重新上架费用。
return_methods[]	ReturnMethod 客户可以通过哪些退货方式退回商品。除非退货政策类型为 noReturns，否则此值不得为空。
item_conditions[]	ItemCondition 除非退货政策类型为“noReturns”，否则接受退货的商品条件不得为空。
return_shipping_fee	ReturnShippingFee 退货运费。仅当客户需要下载和打印退货单时，才应设置此属性。
return_policy_uri	string 必需。退货政策 URI。Google 可以使用此信息对政策进行合理性检查。此值必须是有效网址。
accept_defective_only	bool 此字段用于指定商家是否仅接受有缺陷的商品的退货，并且此字段为必填字段。
process_refund_days	int32 此字段用于指定商家处理退款所需的天数，该字段为可选字段。
accept_exchange	bool 此字段用于指定商家是否允许客户换货，此字段为必填字段。

ItemCondition

可用的商品状况。

枚举
ITEM_CONDITION_UNSPECIFIED	默认值。此值未使用。
NEW	新建。
USED	已使用。

政策

可用的政策。

字段
type	Type 政策类型。
days	int64 商品送达后的退货期限（天数），其中一天定义为送达时间戳后的 24 小时。NUMBER_OF_DAYS_AFTER_DELIVERY 返回时必需。

类型

退货政策类型。

枚举
TYPE_UNSPECIFIED	默认值。此值未使用。
NUMBER_OF_DAYS_AFTER_DELIVERY	商品送达后可退货的天数。
NO_RETURNS	不可退货。
LIFETIME_RETURNS	终身可退货。

RestockingFee

重新上架费。这可以是固定费用或微百分比。

字段
联合字段 type。 type 只能是下列其中一项：
fixed_fee	Price 固定的重新上架费。
micro_percent	int32 以百万分之一表示的总价百分比。15,000,000 表示系统会收取总价的 15%。

ReturnMethod

可用的退货方式。

枚举
RETURN_METHOD_UNSPECIFIED	默认值。此值未使用。
BY_MAIL	通过邮寄方式退回。
IN_STORE	在实体店内退货。
AT_A_KIOSK	在自助服务终端退货。

ReturnShippingFee

退货运费。这可以是固定费用，也可以是布尔值，用于指明客户支付实际运费。

字段
type	Type 必需。退货运费的类型。
fixed_fee	Price 固定的退货运费金额。此值仅适用于类型为 FIXED 时。如果 type 为 FIXED 且未设置此值，我们将将退货运费视为免运费。

类型

退货运费类型。

枚举
TYPE_UNSPECIFIED	默认值。此值未使用。
FIXED	退货运费为固定值。
CUSTOMER_PAYING_ACTUAL_FEE	客户需支付实际的退货运费。

PhoneVerificationState

电话验证状态。

枚举
PHONE_VERIFICATION_STATE_UNSPECIFIED	默认值。此值未使用。
PHONE_VERIFICATION_STATE_VERIFIED	手机已通过验证。
PHONE_VERIFICATION_STATE_UNVERIFIED	手机未验证

计划

定义指定账号参与的指定计划。

计划提供了一种向商家账号添加功能的机制。一个典型的例子就是非付费商品详情计划，该计划可让商家在 Google 各平台上免费展示其商店中的商品。

字段
name	string 标识符。课程的资源名称。格式：accounts/{account}/programs/{program}
documentation_uri	string 仅限输出。指向介绍该计划的 Merchant Center 帮助页面的网址。
state	State 仅限输出。账号在该计划中的参与状态。
active_region_codes[]	string 仅限输出。账号正在积极参与该计划的区域。活跃地区是指已满足影响该地区的所有计划要求的地区。 地区代码由 CLDR 定义。如果计划仅适用于某个国家/地区，则填写该国家/地区；如果计划在全球范围内适用，则填写 001。
unmet_requirements[]	Requirement 仅限输出。账号尚未满足的会影响其参与计划的要求。

要求

定义参与该计划的指定要求。

字段
title	string 仅限输出。要求的名称。
documentation_uri	string 仅限输出。说明相应要求的帮助页面的网址。
affected_region_codes[]	string 仅限输出。目前受此要求不满足影响的地区。 地区代码由 CLDR 定义。如果计划仅适用于某个国家/地区，则填写该国家/地区；如果计划在全球范围内适用，则填写 001。

州

账号可能的计划参与状态。

枚举
STATE_UNSPECIFIED	默认值。此值未使用。
NOT_ELIGIBLE	该账号不符合参与该计划的条件。
ELIGIBLE	账号符合参与该计划的条件。
ENABLED	该账号已启用该计划。

RateGroup

配送费率组定义。只有最后一个组可以包含空的 applicable_shipping_labels，表示“所有其他内容”。其他 applicable_shipping_labels 不得重叠。

字段
applicable_shipping_labels[]	string 必需。配送标签列表，用于定义此费率组适用的商品。这是一个析取运算：只要其中一个标签匹配，费率组就会应用。只有服务的最后一个费率组可以为空。
subtables[]	Table 可选。main_table 引用的子表的列表。仅当已设置 main_table 时才能设置此项。
carrier_rates[]	CarrierRate 可选。可由 main_table 或 single_value 引用的运营商费率列表。
single_value	Value 费率组的值（例如固定费率 10 美元）。只有在未设置 main_table 和 subtables 时才能设置此项。
main_table	Table 当 single_value 表达力不足时，用于定义费率组的表。仅当未设置 single_value 时才能设置此项。
name	string 可选。费率组的名称。如果已设置，则必须在配送服务中是唯一的。

区域

表示您可以在 RegionalInventory 和 ShippingSettings 服务中用作目标的地理区域。您可以将地区定义为邮政编码的集合，也可以在某些国家/地区使用预定义的地理定位条件。如需了解详情，请参阅设置地区 。

字段
name	string 标识符。地区的资源名称。格式：accounts/{account}/regions/{region}
postal_code_area	PostalCodeArea 可选。用于定义地区区域的邮政编码列表。
geotarget_area	GeoTargetArea 可选。用于定义地区区域的地理位置定位目标列表。
regional_inventory_eligible	BoolValue 仅限输出。指示相应地区是否符合在地区商品目录配置中使用的条件。
shipping_eligible	BoolValue 仅限输出。指示相应地区是否符合在配送服务配置中使用的条件。
display_name	string 可选。地区的显示名称。

GeoTargetArea

用于定义地区区域的地理位置定位目标列表。

字段
geotarget_criteria_ids[]	int64 必需。地理位置 ID 的非空列表。它们都必须属于同一地理位置类型（例如州）。

PostalCodeArea

用于定义地区区域的邮政编码列表。注意：您可以通过账号的 ShippingSettings.postalCodeGroups 资源访问使用邮政编码定义的所有地区。

字段
region_code	string 必需。CLDR 地区代码或邮政编码组适用的国家/地区。
postal_codes[]	PostalCodeRange 必需。邮政编码范围。

PostalCodeRange

用于定义地区区域的一组邮政编码。

字段
begin	string 必需。邮政编码或采用“前缀*”格式的模式，表示定义区域范围的下限（包括该下限）。示例值：94108、9410*、9*。
end	string 可选。邮政编码或采用 prefix* 格式的模式，表示定义相应区域的范围的上限（包括该上限）。其长度必须与 postalCodeRangeBegin 相同：如果 postalCodeRangeBegin 是邮政编码，则 postalCodeRangeEnd 也必须是邮政编码；如果 postalCodeRangeBegin 是模式，则 postalCodeRangeEnd 也必须是前缀长度相同的模式。可选：如果未设置，则该区域定义为与 postalCodeRangeBegin 匹配的所有邮政编码。

必填

说明必须接受的服务条款。

字段
terms_of_service	string 需要接受的termsOfService。
tos_file_uri	string 服务条款文件的完整网址。此字段与 TermsOfService.file_uri 相同，仅出于方便起见而添加在此处。

RetrieveForApplicationTermsOfServiceAgreementStateRequest

对 RetrieveForApplicationTermsOfServiceAgreementState 方法的请求消息。

字段
parent	string 必需。要获取 TermsOfServiceAgreementState 的账号。格式：accounts/{account}

RetrieveLatestTermsOfServiceRequest

对 RetrieveLatestTermsOfService 方法的请求消息。

字段
region_code	string 必需。由 CLDR 定义的地区代码。如果服务条款仅适用于某个国家/地区，则此字段应填写相应国家/地区的代码；如果服务条款适用于全球，则应填写 001。
kind	TermsOfServiceKind 必需。此服务条款版本适用的类型。

行

添加单元格列表。

字段
cells[]	Value 必需。构成该行的单元格列表。对于二维表格，必须与 columnHeaders 的长度相同；对于一维表格，长度为 1。

服务

配送服务。

字段
delivery_countries[]	string 必需。服务适用的国家/地区的 CLDR 地区代码。
rate_groups[]	RateGroup 可选。配送费率组定义。只有最后一个组可以包含空的 applicable_shipping_labels，表示“所有其他内容”。其他 applicable_shipping_labels 不得重叠。
loyalty_programs[]	LoyaltyProgram 可选。此配送服务仅适用于的会员回馈活动。
service_name	string 必需。服务的自由形式名称。在目标账号中必须是唯一的。
active	bool 必需。一个布尔值，用于显示配送服务的有效状态。
currency_code	string 此服务适用的币种的 CLDR 代码。必须与费率组中的价格一致。
delivery_time	DeliveryTime 必需。从下单到商品送达所花费的各个方面时间。
shipment_type	ShipmentType 此服务可配送到的地点类型。
minimum_order_value	Price 此服务的最低订单金额。如果设置，则表示客户必须至少消费此金额。同一服务中的所有价格都必须采用相同的币种。不能与 minimum_order_value_table 一起设置。
minimum_order_value_table	MinimumOrderValueTable 下表显示了每家商店针对自提履单类型的最低订单金额。不能与 minimum_order_value 一起设置。
store_config	StoreConfig 商品发货商店的列表。此属性仅适用于本地配送配送类型。

LoyaltyProgram

商家提供的会员回馈活动。

字段
loyalty_program_tiers[]	LoyaltyProgramTiers 可选。此配送服务的会员回馈活动层级。
program_label	string 这是您在 Merchant Center 的会员回馈活动设置中设定的会员回馈活动标签。通过该子属性，Google 可以将您的会员回馈活动映射到符合条件的商品。

LoyaltyProgramTiers

商家会员回馈活动的子集。

字段
tier_label	string 层级标签 [tier_label] 子属性用于区分各个层级的商品级福利。此值也是在 Merchant Center 的会员回馈活动设置中设定的；即使您的会员回馈活动只有一个层级，在更改数据源时也必须提供此子属性。

ShipmentType

配送服务的配送类型。

枚举
SHIPMENT_TYPE_UNSPECIFIED	此服务未指定配送类型。
DELIVERY	此服务会将订单配送到客户选择的地址。
LOCAL_DELIVERY	此服务会将订单配送到客户选择的地址。订单将从附近的本地商店发货。
COLLECTION_POINT	此服务会将订单配送到客户选择的地址。订单从取件点发货。

StoreConfig

商品发货商店的列表。此属性仅适用于本地配送配送类型。

字段
store_codes[]	string 可选。提供本地配送的实体店代码列表。如果为空，则 all_stores 必须为 true。
store_service_type	StoreServiceType 指明此商家列出的所有商店或部分商店是否提供本地配送服务。
cutoff_config	CutoffConfig 与本地送达相关的配置当天结束。
service_radius	Distance 最大配送半径。只有本地配送配送类型才需要此属性。

CutoffConfig

与本地送达相关的配置当天结束。

字段
local_cutoff_time	LocalCutoffTime 当天本地送达服务的结束时间。
store_close_offset_hours	int64 仅适用于本地送货方式。以商店打烊前的小时数表示截止时间。它与 local_cutoff_time 是互斥的。
no_delivery_post_cutoff	bool 如果商家将配送服务配置为“n 天送达”，则可以选择不显示“n+1 天送达”。例如，如果配送服务定义了当天送达，并且已超过截止时间，将此字段设置为 true 会导致计算出的配送服务费率返回 NO_DELIVERY_POST_CUTOFF。在同一示例中，将此字段设置为 false 会导致计算出的送货时间为 1 天。此功能仅适用于本地配送。

LocalCutoffTime

当天本地送达服务的结束时间。

字段
hour	int64 当天送达服务的订单必须在截止时间之前下单，才能当天处理。
minute	int64 必须在分钟级本地送达服务的下单截止时间之前下单，才能当天处理。

StoreServiceType

指明商家列出的所有商店或部分商店是否提供本地配送服务。

枚举
STORE_SERVICE_TYPE_UNSPECIFIED	未指定商店服务类型。
ALL_STORES	指示此商家列出的所有当前和未来的商店是否提供本地配送服务。
SELECTED_STORES	表示只有 store_codes 中列出的商店符合本地配送条件。

ShippingSettings

商家账号的配送设置。

字段
name	string 标识符。配送设置的资源名称。格式：accounts/{account}/shippingSetting
services[]	Service 可选。目标账号的服务列表。
warehouses[]	Warehouse 可选。可在 services 中引用的仓库列表。
etag	string 必需。此字段用于避免异步问题。请确保在 get 调用和 insert 调用之间，配送设置数据没有更改。用户应执行以下步骤： 将 etag 字段设置为空字符串，以便初始创建配送设置。 初始创建后，请调用 get 方法以获取 etag 和当前配送设置数据，然后再调用 insert。 修改为所需的配送设置信息。 使用从第 2 步中获取的 etag 调用 insert 方法，并提供所需的配送设置信息。 如果配送设置数据在第 2 步和第 4 步之间发生了变化。由于每次运费设置数据发生变化时 etag 都会发生变化，因此插入请求将会失败。用户应使用新的 etag 重复第 2-4 步。

表

当 single_value 表达力不足时，用于定义费率组的表格。

字段
rows[]	Row 必需。构成表格的行列表。必须与 row_headers 的长度相同。
name	string 表的名称。子表格需要提供，主表格会被忽略。
row_headers	Headers 必需。表格的行标题。
column_headers	Headers 表格的列标题。可选：如果未设置，则表格只有一个维度。

TermsOfService

TermsOfService 邮件代表服务条款的特定版本，商家必须接受该版本才能使用某些功能或服务（请参阅 https://support.google.com/merchants/answer/160173)。

此消息对于新手入门流程至关重要，可确保商家同意使用服务所需的法律协议。商家可以通过 RetrieveLatestTermsOfService 检索给定 kind 和 region 的最新服务条款，并根据需要通过 AcceptTermsOfService 接受这些条款。

字段
name	string 标识符。服务条款版本的资源名称。格式：termsOfService/{version}
region_code	string 由 CLDR 定义的地区代码。此字段表示服务条款仅适用于特定国家/地区，如果同一 TermsOfService 可在任何国家/地区签署，则填写 001。不过请注意，在签署适用于全球的服务条款时，我们仍希望您提供特定国家/地区（应为商家所在国家/地区或参与计划的国家/地区）。
kind	TermsOfServiceKind 此服务条款版本适用的类型。
external	bool 此服务条款版本是否为外部版本。外部服务条款版本只能通过外部流程达成一致，而不能由商家直接通过界面或 API 达成一致。
file_uri	string 需要向签约用户显示的服务条款文件的 URI。

TermsOfServiceAgreementState

此资源表示给定账号的协议状态和服务条款类型。状态如下：

• 如果商家已接受服务条款：系统会填充 accepted，否则将为空
• 如果商家必须签署服务条款，系统会填充“必填”，否则将留空。

请注意，必需和接受均可存在。在这种情况下，accepted 服务条款将在 valid_until 字段中设置失效日期。账号需要在 valid_until 之前接受 required 服务条款，才能继续拥有有效的协议。在接受新服务条款时，我们希望第三方显示与给定服务条款协议相关联的文本（包含文本的文件的网址会添加到下方的“必需”消息中，作为 tos_file_uri）。实际接受服务条款是通过对 TermsOfService 资源调用 accept 方法来完成的。

字段
name	string 标识符。服务条款版本的资源名称。格式：accounts/{account}/termsOfServiceAgreementState/{identifier} 标识符格式为：{TermsOfServiceKind}-{country}例如，标识符可以是：MERCHANT_CENTER-US
region_code	string 地区代码，如 https://cldr.unicode.org/ 中所定义。这是当前状态适用的国家/地区。
terms_of_service_kind	TermsOfServiceKind 与特定版本关联的服务条款类型。
accepted	Accepted 已接受的此类服务条款以及关联的 region_code
required	Required 必需接受的服务条款

TermsOfServiceKind

TermsOfService 类型。

枚举
TERMS_OF_SERVICE_KIND_UNSPECIFIED	默认值。此值未使用。
MERCHANT_CENTER	Merchant Center 应用。

TransitTable

运送时间表，根据行和列维度显示运送所需的工作日数。您可以设置 min_transit_days、max_transit_days 或 transit_time_table，但不能同时设置这两者。

字段
postal_code_group_names[]	string 必需。区域名称列表 Region.name。最后一个值可以是 "all other locations"。示例：["zone 1", "zone 2", "all other locations"]。提及的邮政编码组必须与服务的送货国家/地区一致。
transit_time_labels[]	string 必需。运送时间标签列表。最后一个值可以是 "all other labels"。示例：["food", "electronics", "all other labels"]。
rows[]	TransitTimeRow 必需。如果只有一个 postal_code_group_names 或 transit_time_labels 维度集，则有多个行，每行包含一个该维度的值。如果有两个维度，则每行对应于 postal_code_group_names，列（值）对应于 transit_time_labels。

TransitTimeRow

如果只有一个 postal_code_group_names 或 transit_time_labels 维度集，则有多个行，每行包含一个该维度的值。如果有两个维度，则每行对应于 postal_code_group_names，列（值）对应于 transit_time_labels。

字段
values[]	TransitTimeValue 必需。运送时间范围（最短-最长）（以工作日计）。

TransitTimeValue

运送时间范围（最短-最长）（以工作日计）。

字段
min_transit_days	int32 最短运送时间范围（以工作日计）。0 表示当天送达，1 表示次日送达。
max_transit_days	int32 必须大于或等于 min_transit_days。

UnclaimHomepageRequest

对 UnclaimHomepage 方法的请求消息。

字段
name	string 必需。要取消声明的首页的名称。格式：accounts/{account}/homepage

UpdateAccountRequest

对 UpdateAccount 方法的请求消息。

字段
account	Account 必需。新版账号。
update_mask	FieldMask 可选。要更新的字段的列表。 支持以下字段（在 snake_case 和 lowerCamelCase 中）： account_name adult_content language_code time_zone

UpdateAutofeedSettingsRequest

对 UpdateAutofeedSettings 方法的请求消息。

字段
autofeed_settings	AutofeedSettings 必需。新版自动 Feed 设置。
update_mask	FieldMask 必需。要更新的字段的列表。

UpdateBusinessIdentityRequest

对 UpdateBusinessIdentity 方法的请求消息。

字段
business_identity	BusinessIdentity 必需。商家身份的新版本。
update_mask	FieldMask 可选。要更新的字段的列表。 支持以下字段（在 snake_case 和 lowerCamelCase 中）： black_owned latino_owned promotions_consent small_business veteran_owned women_owned

UpdateBusinessInfoRequest

对 UpdateBusinessInfo 方法的请求消息。

字段
business_info	BusinessInfo 必需。新版商家信息。
update_mask	FieldMask 可选。要更新的字段的列表。 支持以下字段（在 snake_case 和 lowerCamelCase 中）： address customer_service korean_business_registration_number

UpdateEmailPreferencesRequest

UpdateEmailPreferences 方法的请求消息。

字段
email_preferences	EmailPreferences 必需。要更新的电子邮件接收设置。
update_mask	FieldMask 必需。要更新的字段的列表。 支持以下字段（在 snake_case 和 lowerCamelCase 中）： news_and_tips

UpdateHomepageRequest

对 UpdateHomepage 方法的请求消息。

字段
homepage	Homepage 必需。首页的新版本。
update_mask	FieldMask 可选。要更新的字段的列表。 支持以下字段（在 snake_case 和 lowerCamelCase 中）： uri

UpdateRegionRequest

对 UpdateRegion 方法的请求消息。

字段
region	Region 必需。更新后的地区。
update_mask	FieldMask 可选。以英文逗号分隔的字段掩码，用于指明要更新的字段。示例："displayName,postalCodeArea.regionCode"。

UpdateUserRequest

对 UpdateUser 方法的请求消息。

字段
user	User 必需。用户的新版本。 使用 me 来引用您自己的电子邮件地址，例如 accounts/{account}/users/me。
update_mask	FieldMask 可选。要更新的字段的列表。 支持以下字段（在 snake_case 和 lowerCamelCase 中）： access_rights

用户

User 消息表示与 Merchant Center 账号关联的用户。它用于管理账号中的用户权限和访问权限。如需了解详情，请参阅关于用户和访问权限级别的常见问题解答。

字段
name	string 标识符。用户的资源名称。格式：accounts/{account}/user/{email} 使用 me 来引用您自己的电子邮件地址，例如 accounts/{account}/users/me。
state	State 仅限输出。用户的状态。
access_rights[]	AccessRight 可选。用户拥有的访问权限。

州

用户可能的状态。

枚举
STATE_UNSPECIFIED	默认值。此值未使用。
PENDING	用户正在等待确认。在此状态下，用户需要先接受邀请，然后才能执行其他操作。
VERIFIED	用户已通过验证。

值

费率组的单个值或费率组表格的单元格的值。必须设置 no_shipping、flat_rate、price_percentage、carrier_rateName、subtable_name 中的一个。

字段
no_shipping	bool 如果为 true，则表示商品无法配送。设置时必须为 true，只有在未设置所有其他字段时才能设置。
flat_rate	Price 固定费率。只有在未设置所有其他字段的情况下才能设置此字段。
price_percentage	string 价格的百分比，表示为小数形式的数字（例如 "5.4"）。仅当所有其他字段均未设置时才能设置。
carrier_rate	string 运输公司费率的名称，是指在同一费率组中定义的运输公司费率。只有在未设置所有其他字段的情况下才能设置此字段。
subtable	string 子表格的名称。只能在表格单元格中设置（例如，不能为单个值设置），并且只有在所有其他字段均未设置的情况下才能设置。

仓库

用于存储和处理商品的履单仓库。

字段
name	string 必需。仓库的名称。在账号中必须是唯一的。
shipping_address	Address 必需。仓库的送货地址。
cutoff_time	WarehouseCutoffTime 必需。可接受订单并开始处理的每日截止时间。之后的订单将在次日处理。时间取决于仓库的邮政编码。
handling_days	int64 必需。此仓库打包和配送商品所需的天数。这是仓库级别的设置，但可以根据商品的属性在商品级别替换。
business_day_config	BusinessDayConfig 仓库的工作日。如果未设置，则默认为周一至周五。

WarehouseBasedDeliveryTime

表示应根据所选运输公司的设置，按仓库（发货地点）计算送货时间。设置此字段后，不应在 delivery_time 中设置任何其他与运送时间相关的字段。

字段
carrier	string 必需。运营商，例如 "UPS" 或 "Fedex"。支持的运营商
carrier_service	string 必需。运营商服务，例如 "ground" 或 "2 days"。服务的名称必须在 eddSupportedServices 列表中。
warehouse	string 必需。仓库名称。此值应与 [warehouse][ShippingSetting.warehouses.name] 相匹配

WarehouseCutoffTime

可接受订单并开始处理的每日截止时间。之后的订单将在次日处理。时间取决于仓库的邮政编码。

字段
hour	int32 必需。截止时间（小时），订单必须在此之前下单，仓库才能在当天处理。小时数以仓库所在的时区为准。
minute	int32 必需。截止时间的分钟数，订单必须在此之前下单，仓库才能在当天处理。分钟数取决于仓库所在的时区。