Package google.shopping.merchant.accounts.v1beta

索引

• AccountIssueService（界面）
• AccountsService（界面）
• BusinessIdentityService（界面）
• BusinessInfoService（界面）
• EmailPreferencesService（界面）
• HomepageService（界面）
• OnlineReturnPolicyService（界面）
• ProgramsService（界面）
• RegionsService（界面）
• ShippingSettingsService（界面）
• TermsOfServiceAgreementStateService（界面）
• TermsOfServiceService（界面）
• UserService（界面）
• AcceptTermsOfServiceRequest（消息）
• Accepted（消息）
• AccessRight（枚举）
• Account（消息）
• AccountIssue（消息）
• AccountIssue.ImpactedDestination（消息）
• AccountIssue.ImpactedDestination.Impact（消息）
• AccountIssue.Severity（枚举）
• Address（消息）
• BusinessDayConfig（消息）
• BusinessDayConfig.Weekday（枚举）
• BusinessIdentity（消息）
• BusinessIdentity.IdentityAttribute（消息）
• BusinessIdentity.IdentityAttribute.IdentityDeclaration（枚举）
• BusinessIdentity.PromotionsConsent（枚举）
• BusinessInfo（消息）
• CarrierRate（消息）
• ClaimHomepageRequest（消息）
• CreateAndConfigureAccountRequest（消息）
• CreateAndConfigureAccountRequest.AcceptTermsOfService（消息）
• CreateAndConfigureAccountRequest.AddAccountService（消息）
• CreateRegionRequest（消息）
• CreateUserRequest（消息）
• CustomerService（消息）
• CutoffTime（消息）
• DeleteAccountRequest（消息）
• DeleteRegionRequest（消息）
• DeleteUserRequest（消息）
• DeliveryTime（消息）
• DisableProgramRequest（消息）
• Distance（消息）
• Distance.Unit（枚举）
• EmailPreferences（消息）
• EmailPreferences.OptInState（枚举）
• EnableProgramRequest（消息）
• GetAccountRequest（消息）
• 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（消息）
• 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 会导致其所有子账号也被删除。执行此方法需要管理员访问权限。 授权范围 需要以下 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 概览。

BusinessIdentityService

用于支持商家身份 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

用于支持 Business Information 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 的子账号。 系统不会更新更新掩码中未明确选择的偏好设置。 对于更新而言，指定“UNCONFIRMED”选择启用状态值无效。 使用 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 仅在此日期（采用世界协调时间）结束之前有效。您必须在该日期之前接受新的付款方式。您可以在必需消息中找到所需 TermsOfService 的信息。

AccessRight

访问权限。

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

账号

账号。

字段
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。

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”）或魁北克等省（以下简称“魁北克”）。
postal_code	string 必需。邮政编码（例如“100000”）。
region_code	string 必需。CLDR 国家/地区代码（例如“US”）。

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

与商家相关的信息集合。

字段
name	string 标识符。商家信息的资源名称。格式：accounts/{account}/businessInfo
address	PostalAddress 可选。商家地址。
phone	PhoneNumber 仅限输出。商家的电话号码。
phone_verification_state	PhoneVerificationState 仅限输出。商家的电话验证状态。
customer_service	CustomerService 可选。商家的客户服务。
korean_business_registration_number	string 可选。10 位数的韩国企业注册号（以短划线分隔，格式为 XXX-XX-XXXXX）。

CarrierRate

可通过 main_table 或 single_value 引用的运输公司费率的列表。

字段
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

CreateAndConfigureAccountRequest

对 CreateAndConfigureAccount 方法的请求消息。

字段
account	Account 必需。要创建的账号。
users[]	CreateUserRequest 可选。要添加到账号的用户。
service[]	AddAccountService 必需。要创建的账号与提供方账号之间的账号服务会在创建过程中进行初始化。至少需要提供一项此类服务。目前仅支持 account_aggregation，这意味着新创建的账号将成为 account_aggregation 服务中定义的提供商的子账号。
accept_terms_of_service	AcceptTermsOfService 可选。在创建账号后立即接受的服务条款 (ToS)。

AcceptTermsOfService

对服务条款资源的引用。

字段
name	string 必需。服务条款版本的资源名称。
region_code	string 必需。由 CLDR 定义的地区代码。如果服务条款是专门针对某个国家/地区，则此处填写的国家/地区；如果服务条款适用于全球，则该字段为 001。

AddAccountService

关于在创建账号期间添加账号服务的其他说明。

字段
联合字段 service_type。目前仅支持多客户父级账号类型。service_type 只能是下列其中一项：
account_aggregation	Empty 该提供商是账号的集合商家。
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 必需。时区标识符，例如“欧洲/苏黎世”。

DeleteAccountRequest

对 DeleteAccount 方法的请求消息。

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

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 点。
min_handling_days	int32 订单发货前所需的最短工作日天数。0 表示当天发货，1 表示次日发货。
max_handling_days	int32 订单发货前所需的最长工作日天数。0 表示当天发货，1 表示次日发货。必须大于或等于 min_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

CloseProgram 方法的请求消息。

字段
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}

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 必需。包含订单价格上限的列表。将 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 必需。包含订单权重上限的列表。通过将 price amount_micros = -1 设置为最终权重的值，可以设为无穷大。例如，[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] 表示标头“<= 10kg”“<= 50kg”和 ">50 千克”。一项服务中的所有权重必须使用相同的单位。不得为空。必须为正数，但 -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 集的列表。不得为空。只有在所有其他字段都未设置时才能设置。

首页

商店首页。

字段
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	TimeZone 可选。用于在人类可读字段中对时间进行本地化的 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”。每个商店代码在所有集合中都只能出现一次。一项服务中的所有价格都必须采用相同的币种。

StoreCodeSetWithMov

具有相同最低订单金额的一系列商店代码。至少需要两组，最后一组必须为空，这表示“适用于所有其他商店的 MOV”。每个商店代码在所有集合中都只能出现一次。一项服务中的所有价格都必须采用相同的币种。

字段
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 时，此值才适用。如果类型为 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 必需。要获取其服务条款协议状态格式的账号：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，则计算的配送时间为一天。这仅适用于本地配送。

LocalCutoffTime

当天本地送货结束的时间。

字段
hour	int64 您必须在 之前按小时处理本地配送订单，才能在当天处理。
minute	int64 本地几分钟外卖订单必须在 之前提交，才能在当天送达。

StoreServiceType

指明商家列出的所有商店或选定的商店是否提供本地送货服务。

枚举
STORE_SERVICE_TYPE_UNSPECIFIED	未指定商店服务类型。
ALL_STORES	指明此商家列出的当前和未来的所有商店是否都提供本地送货服务。
SELECTED_STORES	表示只有 store_codes 中列出的商店才支持本地配送。

ShippingSettings

商家账号的 [配送设置]((https://support.google.com/merchants/answer/6069284)。

字段
name	string 标识符。运费设置的资源名称。格式：accounts/{account}/shippingSetting
services[]	Service 可选。目标账号的服务列表。
warehouses[]	Warehouse 可选。可在 services 中引用的仓库列表。
etag	string 必需。此字段用于避免异步问题。确保在 get call 和 insert call 之间未更改运费设置数据。用户应按以下步骤操作： 在创建初始运费设置时，将 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。

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

TermsOfServiceAgreementState

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

• 如果商家已接受服务条款：将填充 accepted，否则将为空
• 如果商家必须签署服务条款：将填充 required，否则将为空。

请注意，可以同时提供 required 和 accepted 这两个字段。在这种情况下，系统会在 valid_until 字段中设置 accepted 服务条款的到期日期。您必须在 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

服务条款种类。

枚举
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 必需。要更新的字段列表。

UpdateBusinessIdentityRequest

对 UpdateBusinessIdentity 方法的请求消息。

字段
business_identity	BusinessIdentity 必需。新版商家身份。
update_mask	FieldMask 必需。要更新的字段列表。

UpdateBusinessInfoRequest

对 UpdateBusinessInfo 方法的请求消息。

字段
business_info	BusinessInfo 必需。新版商家信息。
update_mask	FieldMask 必需。要更新的字段列表。

UpdateEmailPreferencesRequest

UpdateEmailPreferences 方法的请求消息。

字段
email_preferences	EmailPreferences 必需。要更新的电子邮件接收设置。
update_mask	FieldMask 必需。要更新的字段列表。

UpdateHomepageRequest

对 UpdateHomepage 方法的请求消息。

字段
homepage	Homepage 必需。新版首页。
update_mask	FieldMask 必需。要更新的字段列表。

UpdateRegionRequest

对 UpdateRegion 方法的请求消息。

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

UpdateUserRequest

对 UpdateUser 方法的请求消息。

字段
user	User 必需。用户的新版本。 使用 me 指代您自己的电子邮件地址，例如 accounts/{account}/users/me。
update_mask	FieldMask 必需。要更新的字段列表。

用户

用户。

字段
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 子表格的名称。只能在表格单元格中设置（例如，不能针对单个值进行设置），并且只有在所有其他字段都未设置时才能进行设置。

仓库

用来存储和处理库存的履单仓库。下一个代码：7

字段
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 必需。截止时间的截止时间，以便仓库在当天处理订单。该分钟数根据仓库所在的时区而定。