REST Resource: accounts.regions

资源:地区

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

JSON 表示法
{
  "name": string,
  "postalCodeArea": {
    object (PostalCodeArea)
  },
  "geotargetArea": {
    object (GeoTargetArea)
  },
  "regionalInventoryEligible": boolean,
  "shippingEligible": boolean,
  "displayName": string
}
字段
name

string

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

postalCodeArea

object (PostalCodeArea)

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

geotargetArea

object (GeoTargetArea)

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

regionalInventoryEligible

boolean

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

shippingEligible

boolean

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

displayName

string

可选。地区的显示名称。

PostalCodeArea

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

JSON 表示法
{
  "regionCode": string,
  "postalCodes": [
    {
      object (PostalCodeRange)
    }
  ]
}
字段
regionCode

string

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

postalCodes[]

object (PostalCodeRange)

必需。邮政编码范围。

PostalCodeRange

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

JSON 表示法
{
  "begin": string,
  "end": string
}
字段
begin

string

必需。邮政编码或采用“前缀*”格式的模式,表示定义区域范围的下限(包括该下限)。示例值:941089410*9*

end

string

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

GeoTargetArea

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

JSON 表示法
{
  "geotargetCriteriaIds": [
    string
  ]
}
字段
geotargetCriteriaIds[]

string (int64 format)

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

方法

create

在您的 Merchant Center 账号中创建地区定义。

delete

从您的 Merchant Center 账号中删除地区定义。

get

检索 Merchant Center 账号中定义的地区。

list

列出 Merchant Center 账号中的地区。

patch

更新 Merchant Center 账号中的地区定义。