Package google.shopping.merchant.accounts.v1beta

string

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

string

必需。要接受服务条款的账号。

string

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

string

已接受的termsOfService。

string

记录接受情况的账号。这可以是账号本身，也可以是子账号的 MCA 账号。

Date

设置此属性后，系统会指明已接受的TermsOfService仅在该日期结束（以 UTC 时间为准）之前有效。您必须在该日期之前接受新的合作规范。您可以在必需消息中找到必需的 TermsOfService 信息。

string

标识符。账号的资源名称。格式：accounts/{account}

int64

仅限输出。账号的 ID。

string

必需。账号的简单易懂的名称。如需了解详情，请参阅商店名称和商家名称。

bool

此账号是否包含成人内容。

bool

仅限输出。此账号是否为测试账号。

TimeZone

必需。账户的时区。

在写入时，time_zone 会同时设置 reporting_time_zone 和 display_time_zone。

对于读取操作，time_zone 始终返回 display_time_zone。如果您的账号不存在 display_time_zone，time_zone 会为空。

string

必需。账号的 BCP-47 语言代码，例如 en-US 或 sr-Latn。

string

标识符。账号问题的资源名称。格式：accounts/{account}/issues/{id}

string

问题的本地化标题。

Severity

问题的总体严重程度。

ImpactedDestination

此问题对各种目标平台的影响。

string

有关该问题的进一步本地化详细信息。

string

指向 Merchant Center 帮助中心的链接，其中详细介绍了此问题以及解决方法。

Impact

给定目标平台在不同地区的负面影响。

ReportingContextEnum

受影响的报告上下文。

string

此问题适用的 CLDR 地区代码。

Severity

问题在目标平台和地区的严重程度。

string

地址的街道级部分。例如：111w 31st Street。

string

必需。城市、镇或公社。还可以包括乡镇/郊区或子级市行政区（例如街区或郊区）。

string

必需。国家/地区的顶级行政区划。例如，加利福尼亚州（“CA”）或魁北克省（“QC”）等州/省。

string

必需。邮政编码（例如“94043”）。

string

必需。CLDR 国家/地区代码（例如“US”）。

string

标识符。自动 Feed 设置的资源名称。格式：accounts/{account}/autofeedSettings。

bool

必需。为指定账号启用或停用通过自动 Feed 抓取商品的功能。自动 Feed 账号必须满足特定条件，您可以通过 eligible 字段查看这些条件。该账号不得是购物平台。首次启用自动 Feed 后，商品通常会立即显示。重新启用后，商品最长可能需要 24 小时才会显示。

bool

仅限输出。确定商家是否符合使用自动 Feed 的条件。

Weekday

必需。正常工作日。不得为空。

string

标识符。商家身份的资源名称。格式：accounts/{account}/businessIdentity

PromotionsConsent

必需。身份属性是否可用于促销。

IdentityAttribute

可选。指定商家是否自称是黑人经营的商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。

IdentityAttribute

可选。指定商家是否自称是女性经营的商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。

IdentityAttribute

可选。指定商家是否将自己标识为退伍军人经营的商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。

IdentityAttribute

可选。指定商家是否自称是拉丁裔所有。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台或购物平台卖家。

IdentityAttribute

可选。指定商家是否将自己标识为小型商家。此选填字段仅适用于将商家所在国家/地区设为 US 的商家。也不适用于购物平台。

IdentityDeclaration

必需。此属性的身份声明。

string

标识符。商家信息的资源名称。格式：accounts/{account}/businessInfo

PostalAddress

可选。商家的地址。仅支持 region_code、address_lines、postal_code、administrative_area 和 locality 字段。系统会忽略所有其他字段。

PhoneNumber

仅限输出。商家的电话号码。

PhoneVerificationState

仅限输出。商家的电话验证状态。

CustomerService

可选。商家的客户服务。

string

可选。10 位数的韩国企业注册号，以英文短划线分隔，格式为 XXX-XX-XXXXX。

string

必需。运营商费率的名称。每个费率组的编号必须是唯一的。

string

必需。运营商服务，例如 "UPS" 或 "Fedex"。

string

必需。运营商服务，例如 "ground" 或 "2 days"。

string

必需。此运输公司费率的配送起点。

string

可选。以十进制表示的乘法配送费率修饰符。可以为负数。例如，"5.4" 会将费率提高 5.4%，"-3" 会将费率降低 3%。

Price

可选。加法运费修饰符。可以为负数。例如，{ "amount_micros": 1, "currency_code" : "USD" } 会将费率增加 1 美元，{ "amount_micros": -3, "currency_code" : "USD" } 会将费率减少 3 美元。

string

必需。要声明的首页的名称。格式：accounts/{account}/homepage

bool

可选。将此选项设置为 true 后，系统会移除所请求网站上的所有现有版权主张，并将其替换为发出请求的账号的版权主张。

Account

必需。要创建的账号。

CreateUserRequest

可选。要添加到账号的用户。

此字段已废弃，在该 API 从 Beta 版升级后将不复存在。请改用 user 字段。

AddUser

可选。要添加到账号的用户。

AddAccountService

必需。在创建过程中，系统会初始化要创建的账号与提供方账号之间的账号服务。需要提供至少一项此类服务。目前，其中必须有一个是 account_aggregation，这意味着您只能通过此方法创建子账号，而不能创建独立账号。可能会提供额外的 account_management 或 product_management 服务。

AccountAggregation

提供商是该账号的聚合信息网站。服务类型为“账号汇总”的载荷。

string

必需。服务的提供商。对账号（例如 providers/123）或知名服务提供商（providers/GOOGLE_ADS 或 providers/GOOGLE_BUSINESS_PROFILE 之一）的引用。

string

必需。用户的电子邮件地址（例如 john.doe@gmail.com）。

User

可选。要添加的用户的详细信息。目前，只能指定访问权限。

string

必需。要为其创建地区的账号。格式：accounts/{account}

string

必需。地区的标识符，在同一账号的所有地区中是唯一的。

Region

必需。要创建的区域。

string

必需。要为其创建用户的账号的资源名称。格式：accounts/{account}

string

必需。用户的电子邮件地址（例如 john.doe@gmail.com）。

User

可选。要创建的用户。

string

可选。用于查找客户服务的 URI。

string

可选。可联系客户服务的电子邮件地址。

PhoneNumber

可选。可拨打的客户服务电话号码。

int32

必需。截止时间（订单必须在此时间之前下单，才能在当天处理）。

int32

必需。截止时间的分钟数，订单必须在此时间之前下单，才能在当天处理。

string

必需。时区标识符，例如“Europe/Zurich”。

string

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

bool

可选。如果设置为 true，系统会删除该账号，即使该账号向其他账号提供服务或处理了商品交易也是如此。

string

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

string

必需。要删除的用户的名称。格式：accounts/{account}/users/{email}

您还可以使用 me（而不是 accounts/{account}/users/me 中的电子邮件地址）删除与调用方对应的用户。

WarehouseBasedDeliveryTime

可选。表示应根据所选运输公司的设置，按仓库（发货地）计算送货时间。设置此字段后，[送货时间][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]] 中的任何其他与运送时间相关的字段均不应设置。

int32

运送所需的最短工作日数。0 表示当天送达，1 表示次日送达。必须设置 min_transit_days、max_transit_days 或 transit_time_table，但不能同时设置这两者。

int32

运送所需的最长工作日数。0 表示当天送达，1 表示次日送达。必须大于或等于 min_transit_days。

CutoffTime

工作日截止时间定义。如果未配置，截止时间将默认为太平洋标准时间上午 8:00。

int32

订单发货前所需的最短工作日天数。0 表示当天发货，1 表示次日发货。“min_handling_days”和“max_handling_days”应同时设置或同时不设置。

int32

订单发货前所需的最长工作日天数。0 表示当天发货，1 表示次日发货。必须大于或等于 min_handling_days。“min_handling_days”和“max_handling_days”应同时设置或不同时设置。

TransitTable

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

BusinessDayConfig

可以处理订单的工作日。如果未提供，系统会假定为周一至周五的工作日。

BusinessDayConfig

订单在运输过程中所需的工作日数。如果未提供，系统会假定为周一至周五的工作日。

string

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

int64

距离的整数值。

Unit

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

string

标识符。EmailPreferences 的名称。此端点仅适用于经过身份验证的用户。

OptInState

可选。有关新功能、提示和最佳实践的最新资讯。

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

必需。要检索的用户的名称。格式：accounts/{account}/users/{email}

您还可以使用 me（而不是 accounts/{account}/users/me 中的电子邮件地址）检索与调用方对应的用户。

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 除外）。只有在所有其他字段均未设置的情况下才能设置此字段。

Weight

必需。包含上限的订单重量上限列表。通过将价格 amount_micros 设置为 -1，可以将最后一个权重的值设为无穷大。例如，[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] 表示标题“<= 10kg”“<= 50kg”和“> 50kg”。服务中的所有权重都必须使用相同的单位。不得为空。必须为正值（-1 除外）。只有在所有其他字段均未设置的情况下才能设置此字段。

string

必需。包含项数量上限（包括该数值）的列表。最后一个值可以是 "infinity"。例如，["10", "50", "infinity"] 表示标题“<= 10 项”“<= 50 项”和“> 50 项”。不得为空。只有在所有其他字段均未设置的情况下才能设置此字段。

string

必需。邮政组名称列表。最后一个值可以是 "all other locations"。示例：["zone 1", "zone 2", "all other locations"]。提及的邮政编码组必须与服务的送货国家/地区一致。不得为空。只有在所有其他字段均未设置的情况下才能设置此字段。

LocationIdSet

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

string

标识符。商店首页的资源名称。格式：accounts/{account}/homepage

bool

仅限输出。首页是否已声明所有权。请参阅 https://support.google.com/merchants/answer/176793。

string

必需。商店首页的 URI（通常是网址）。

string

必需。要插入此商品的账号。格式：accounts/{account}

ShippingSettings

必需。新版账号。

string

必需。拥有此问题集合的父级。格式：accounts/{account}

int32

可选。要返回的最大问题数。服务返回的值可能小于此值。如果未指定，则最多返回 50 位用户。最大值为 100；高于 100 的值将强制转换为 100

string

可选。从之前的 ListAccountIssues 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListAccountIssues 的所有其他参数必须与提供页面令牌的调用匹配。

string

可选。响应中的错误将包含以指定语言提供的直观易懂的字段。格式为 BCP-47，例如 en-US 或 sr-Latn。如果未提供任何值，系统将使用 en-US。

string

可选。用于在人类可读字段中本地化时间的 IANA 时区。例如“America/Los_Angeles”。如果未设置，则使用“America/Los_Angeles”。

AccountIssue

指定账号存在的问题。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

int32

可选。要返回的账号数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 250 个账号。最大值为 500；大于 500 的值会强制转换为 500。

string

可选。从之前的 ListAccounts 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListAccounts 的所有其他参数必须与提供页面令牌的调用匹配。

string

可选。仅返回与过滤条件匹配的账号。如需了解详情，请参阅过滤条件语法参考文档。

Account

与 ListAccountsRequest 匹配的账号。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

必需。要列出退货政策的商家账号。格式：accounts/{account}

int32

可选。要返回的 OnlineReturnPolicy 资源数上限。如果给定商家的退货政策数量少于 pageSize，则该服务返回的数量会少于此值。默认值为 10。最大值为 100；如果指定的值高于上限，则 pageSize 将默认为上限

string

可选。从之前的 ListOnlineReturnPolicies 调用接收的页面令牌。提供页面令牌以检索后续页面。

进行分页时，提供给 ListOnlineReturnPolicies 的所有其他参数必须与提供页面令牌的调用相一致。在对上一个请求的响应中作为 nextPageToken 返回的令牌。

OnlineReturnPolicy

检索到的退货政策。

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

必需。要检索其所有计划的账号的名称。格式：accounts/{account}

int32

可选。单个响应中可返回的节目数量上限。如果未指定（或 0），则使用默认大小 1000。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。

string

可选。从之前的 ListPrograms 调用接收的续订令牌。提供此令牌以检索下一页。

Program

指定账号的计划。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

必需。要列出其地区的账号。格式：accounts/{account}

int32

可选。要返回的区域数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个区域。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。

string

可选。从之前的 ListRegions 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListRegions 的所有其他参数必须与提供页面令牌的调用匹配。

Region

指定商家的地区。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

必需。汇总服务提供商。格式：providers/{providerId}

int32

可选。要返回的账号数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 250 个账号。最大值为 500；大于 500 的值会强制转换为 500。

string

可选。从之前的 ListAccounts 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListAccounts 的所有其他参数必须与提供页面令牌的调用匹配。

Account

指定父级账号的汇总账号。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

必需。拥有此用户集合的父级。格式：accounts/{account}

int32

可选。要返回的用户数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 位用户。最大值为 100；高于 100 的值将强制转换为 100

string

可选。从之前的 ListUsers 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListUsers 的所有其他参数必须与提供页面令牌的调用匹配。

User

指定账号中的用户。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

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

StoreCodeSetWithMov

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

string

可选。唯一商店代码的列表，如果是全局性代码，则为空。

Price

指定商店的最低订单金额。

string

标识符。OnlineReturnPolicy 资源的名称。格式：accounts/{account}/onlineReturnPolicies/{return_policy}

string

仅限输出。Google 生成的退货政策 ID。

string

必需。不可变。此字段表示退货政策的用户定义的唯一标签。请务必注意，同一国家/地区的不同退货政策不能使用相同的标签。除非商品指定了特定的标签属性，否则系统会自动将政策标记为“默认”。如需为特定商品组分配自定义退货政策，请按照退货政策标签中提供的说明操作。标签最多可包含 50 个字符。

string

必需。不可变。退货政策适用的销售国家/地区。值必须是有效的 2 个字母 ISO 3166 代码。

Policy

退货政策。

SeasonalOverride

可选。针对在特定时间间隔内下单的订单对一般政策的替换项。

RestockingFee

适用于所有退货原因类别的重新上架费。如果未设置此值，则系统会将其视为免费的重新上架费用。

ReturnMethod

客户可以通过哪些退货方式退回商品。除非退货政策类型为 noReturns，否则此值不得为空。

ItemCondition

除非退货政策类型为“noReturns”，否则接受退货的商品条件不得为空。

ReturnShippingFee

退货运费。仅当客户需要下载和打印退货单时，才应设置此属性。

string

必需。退货政策 URI。Google 可以使用此信息对政策进行合理性检查。此值必须是有效网址。

bool

此字段用于指定商家是否仅接受有缺陷的商品的退货，并且此字段为必填字段。

int32

此字段用于指定商家处理退款所需的天数，该字段为可选字段。

bool

此字段用于指定商家是否允许客户换货，此字段为必填字段。

Type

政策类型。

int64

商品送达后的退货期限（天数），其中一天定义为送达时间戳后的 24 小时。NUMBER_OF_DAYS_AFTER_DELIVERY 返回时必需。

Price

固定的重新上架费。

int32

以百万分之一表示的总价百分比。15,000,000 表示系统会收取总价的 15%。

Type

必需。退货运费的类型。

Price

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

string

必需。Merchant Center 中此季节性替换项的显示名称。

Date

必需。定义此季节性替换政策适用的日期范围。开始日期和结束日期都包含在内，并且应采用日期小数格式，例如 20250115。季节性替换政策的日期不得重叠。

Date

必填。季节性替换政策的结束日期（含此日期）。

Policy

必需。指定日期范围的退货政策。

string

标识符。课程的资源名称。格式：accounts/{account}/programs/{program}

string

仅限输出。指向介绍该计划的 Merchant Center 帮助页面的网址。

State

仅限输出。账号在该计划中的参与状态。

string

仅限输出。账号正在积极参与该计划的区域。活跃地区是指已满足影响该地区的所有计划要求的地区。

地区代码由 CLDR 定义。如果计划仅适用于某个国家/地区，则填写该国家/地区；如果计划在全球范围内适用，则填写 001。

Requirement

仅限输出。账号尚未满足的会影响其参与计划的要求。

string

仅限输出。要求的名称。

string

仅限输出。说明相应要求的帮助页面的网址。

string

仅限输出。目前受此要求不满足影响的地区。

地区代码由 CLDR 定义。如果计划仅适用于某个国家/地区，则填写该国家/地区；如果计划在全球范围内适用，则填写 001。

string

必需。配送标签列表，用于定义此费率组适用的商品。这是一个析取运算：只要其中一个标签匹配，费率组就会应用。只有服务的最后一个费率组可以为空。

Table

可选。main_table 引用的子表的列表。仅当已设置 main_table 时才能设置此项。

CarrierRate

可选。可由 main_table 或 single_value 引用的运营商费率列表。

Value

费率组的值（例如固定费率 10 美元）。只有在未设置 main_table 和 subtables 时才能设置此项。

Table

当 single_value 表达力不足时，用于定义费率组的表。仅当未设置 single_value 时才能设置此项。

string

可选。费率组的名称。如果已设置，则必须在配送服务中是唯一的。

string

标识符。地区的资源名称。格式：accounts/{account}/regions/{region}

PostalCodeArea

可选。用于定义地区区域的邮政编码列表。

GeoTargetArea

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

BoolValue

仅限输出。指示相应地区是否符合在地区商品目录配置中使用的条件。

BoolValue

仅限输出。指示相应地区是否符合在配送服务配置中使用的条件。

string

可选。地区的显示名称。

int64

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

string

必需。CLDR 地区代码或邮政编码组适用的国家/地区。

PostalCodeRange

必需。邮政编码范围。

string

必需。邮政编码或格式为前缀* 的模式，表示定义区域范围的下限（包括该下限）。示例值：94108、9410*、9*。

string

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

string

需要接受的termsOfService。

string

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

string

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

string

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

TermsOfServiceKind

必需。此服务条款版本适用的类型。

Value

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

string

必需。服务适用的国家/地区的 CLDR 地区代码。

RateGroup

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

LoyaltyProgram

可选。此配送服务仅适用于的会员回馈活动。

string

必需。服务的自由形式名称。在目标账号中必须是唯一的。

bool

必需。一个布尔值，用于显示配送服务的有效状态。

string

此服务适用的币种的 CLDR 代码。必须与费率组中的价格一致。

DeliveryTime

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

ShipmentType

此服务可配送到的地点类型。

Price

此服务的最低订单金额。如果设置，则表示客户必须至少消费此金额。服务中的所有价格都必须采用相同的币种。不能与 minimum_order_value_table 一起设置。

MinimumOrderValueTable

自提履单类型的每家商店最低订单金额表格。不能与 minimum_order_value 一起设置。

StoreConfig

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

LoyaltyProgramTiers

可选。此配送服务的会员回馈活动层级。

string

这是您在 Merchant Center 的会员回馈活动设置中设定的会员回馈活动标签。通过该子属性，Google 可以将您的会员回馈活动映射到符合条件的商品。

string

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

string

可选。提供本地配送的实体店代码列表。如果为空，则 all_stores 必须为 true。

StoreServiceType

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

CutoffConfig

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

Distance

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

LocalCutoffTime

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

int64

仅适用于本地送货方式。以商店打烊前的小时数表示截止时间。它与 local_cutoff_time 是互斥的。

bool

如果商家将配送服务配置为“n 天送达”，则可以选择不显示“n+1 天送达”。例如，如果配送服务定义了当天送达，并且已超过截止时间，将此字段设置为 true 会导致计算出的配送服务费率返回 NO_DELIVERY_POST_CUTOFF。在同一示例中，将此字段设置为 false 会导致计算出的送货时间为 1 天。此功能仅适用于本地配送。

int64

当天送达服务的订单必须在截止时间之前下单，才能当天处理。

int64

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

string

标识符。配送设置的资源名称。格式：accounts/{account}/shippingSetting

Service

可选。目标账号的服务列表。

Warehouse

可选。可在 services 中引用的仓库列表。

string

必需。此字段用于避免异步问题。请确保在 get 调用和 insert 调用之间，配送设置数据没有更改。用户应执行以下步骤：

1. 将 etag 字段设置为空字符串，以便初始创建配送设置。

2. 初始创建后，请调用 get 方法以获取 etag 和当前配送设置数据，然后再调用 insert。

3. 修改为所需的配送设置信息。

4. 使用从第 2 步中获取的 etag 调用 insert 方法，并提供所需的配送设置信息。

5. 如果配送设置数据在第 2 步和第 4 步之间发生了变化。由于每次运费设置数据发生变化时 etag 都会发生变化，因此插入请求将会失败。用户应使用新的 etag 重复第 2-4 步。

Row

必需。构成表格的行列表。必须与 row_headers 的长度相同。

string

表的名称。子表格需要提供，主表格会被忽略。

Headers

必需。表格的行标题。

Headers

表格的列标题。可选：如果未设置，则表格只有一个维度。

string

标识符。服务条款版本的资源名称。格式：termsOfService/{version}

string

由 CLDR 定义的地区代码。此字段表示服务条款仅适用于特定国家/地区，如果同一 TermsOfService 可在任何国家/地区签署，则填写 001。不过请注意，在签署适用于全球的服务条款时，我们仍希望您提供特定国家/地区（应为商家所在国家/地区或参与计划的国家/地区）。

TermsOfServiceKind

此服务条款版本适用的类型。

bool

此服务条款版本是否为外部版本。外部服务条款版本只能通过外部流程达成一致，而不能由商家直接通过界面或 API 达成一致。

string

需要向签约用户显示的服务条款文件的 URI。

string

标识符。服务条款版本的资源名称。格式：accounts/{account}/termsOfServiceAgreementState/{identifier} 标识符格式为：{TermsOfServiceKind}-{country}例如，标识符可以是：MERCHANT_CENTER-US

string

地区代码，如 https://cldr.unicode.org/ 中所定义。这是当前状态适用的国家/地区。

TermsOfServiceKind

与特定版本关联的服务条款类型。

Accepted

已接受的此类服务条款以及关联的 region_code

Required

必要的服务条款

string

必需。区域名称列表 Region.name。最后一个值可以是 "all other locations"。示例：["zone 1", "zone 2", "all other locations"]。提及的邮政编码组必须与服务的送货国家/地区一致。

string

必需。运送时间标签列表。最后一个值可以是 "all other labels"。示例：["food", "electronics", "all other labels"]。

TransitTimeRow

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

TransitTimeValue

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

int32

最短运送时间范围（以工作日计）。0 表示当天送达，1 表示次日送达。

int32

必须大于或等于 min_transit_days。

string

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

Account

必需。新版账号。

FieldMask

可选。要更新的字段的列表。

支持以下字段（在 snake_case 和 lowerCamelCase 中）：

• account_name
• adult_content
• language_code
• time_zone

AutofeedSettings

必需。新版自动 Feed 设置。

FieldMask

必需。要更新的字段的列表。

BusinessIdentity

必需。商家身份的新版本。

FieldMask

可选。要更新的字段的列表。

支持以下字段（在 snake_case 和 lowerCamelCase 中）：

• black_owned
• latino_owned
• promotions_consent
• small_business
• veteran_owned
• women_owned

BusinessInfo

必需。新版商家信息。

FieldMask

可选。要更新的字段的列表。

支持以下字段（在 snake_case 和 lowerCamelCase 中）：

• address
• customer_service
• korean_business_registration_number

EmailPreferences

必需。要更新的电子邮件接收设置。

FieldMask

必需。要更新的字段的列表。

支持以下字段（在 snake_case 和 lowerCamelCase 中）：

• news_and_tips

Homepage

必需。首页的新版本。

FieldMask

可选。要更新的字段的列表。

支持以下字段（在 snake_case 和 lowerCamelCase 中）：

• uri

Region

必需。更新后的地区。

FieldMask

可选。逗号分隔的字段掩码，用于指明要更新的字段。示例："displayName,postalCodeArea.regionCode"。

User

必需。用户的新版本。

使用 me 来引用您自己的电子邮件地址，例如 accounts/{account}/users/me。

FieldMask

可选。要更新的字段的列表。

支持以下字段（在 snake_case 和 lowerCamelCase 中）：

• access_rights

string

标识符。用户的资源名称。格式：accounts/{account}/user/{email}

使用 me 来引用您自己的电子邮件地址，例如 accounts/{account}/users/me。

State

仅限输出。用户的状态。

AccessRight

可选。用户拥有的访问权限。

bool

如果为 true，则表示商品无法配送。设置时必须为 true，只有在未设置所有其他字段时才能设置。

Price

固定费率。只有在所有其他字段均未设置的情况下才能设置此字段。

string

价格的百分比，表示为小数形式的数字（例如 "5.4"）。仅当所有其他字段均未设置时才能设置。

string

运输公司费率的名称，是指在同一费率组中定义的运输公司费率。只有在所有其他字段均未设置的情况下才能设置此字段。

string

子表格的名称。只能在表格单元格中设置（例如，不能为单个值设置），并且只有在所有其他字段均未设置的情况下才能设置。

string

必需。仓库的名称。在账号中必须是唯一的。

Address

必需。仓库的送货地址。

WarehouseCutoffTime

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

int64

必需。此仓库打包和配送商品所需的天数。这是仓库级别的设置，但可以根据商品的属性在商品级别替换。

BusinessDayConfig

仓库的工作日。如果未设置，则默认为周一至周五。

string

必需。运营商，例如 "UPS" 或 "Fedex"。支持的运营商

string

必需。运营商服务，例如 "ground" 或 "2 days"。服务的名称必须在 eddSupportedServices 列表中。

string

必需。仓库名称。此值应与 [warehouse][ShippingSetting.warehouses.name] 相匹配

int32

必需。截止时间（小时），订单必须在此之前下单，仓库才能在当天处理。小时数以仓库所在的时区为准。

int32

必需。截止时间的分钟数，订单必须在此之前下单，仓库才能在当天处理。分钟数取决于仓库所在的时区。