REST Resource: inventory.partners.merchants

{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}

string

商家资源的名称，格式为 partners/{partner_id}/merchants/{merchantId}。

string

merchantName、telephone、url 和 geo 用于将合作伙伴商品目录与 Google 地图上已有的商家进行匹配。此信息不会显示。

商家的名称。

string

包含国家/地区代码的商家公开电话号码，例如 +14567891234。

string

商家公共网站的网址。

object (GeoCoordinates)

商家的地理位置信息，包括纬度、经度和地址。

string

集合商家平台中商家的类别。

string (int64 format)

该字段已弃用。

integer (uint32 format)

商家的税率（以 0.01% 为基准点）。例如，如果税率为 7.5%，应将该字段设置为 750。

如果未设置或将该字段设置为 0，对于由此商家提供的任何服务，向用户收取的总费用为 Service.price 所指定的确切价格。该服务价格被视为无需缴纳税费或已包含适用税费。系统不会将税费作为单独的订单项向用户显示。

如果将该字段设置为任何非零值，对于由此商家提供的任何服务，向用户收取的总费用将包含服务价格以及使用此处提供的税率计算得出的税费。最小货币单位的小数部分（例如，1 美分的小数部分）将四舍五入为最接近的偶数。系统会将税费作为单独的订单项向用户显示。

此字段已弃用，请改用 taxRate。

object (TaxRate)

商家的税率。如果设置该字段，它会替换已弃用的 taxRateBasisPoints 字段。如果消息为空（即 taxRate { }），系统会将适用的税率重置为零。

object (PaymentRestrictions)

对此商家所接受付款方式的限制。如果未设置此字段，表示无任何限制。

object (PaymentOption)

此商家所支持的付款方式。此商家的服务将能够单独限制其允许的付款方式。

object (PaymentProcessorConfig)

适用于令牌化付款处理方的配置（如果商家支持）。

object (TokenizationConfig)

适用于令牌化付款处理方的配置（如果商家支持）。

object (Terms)

特定商家的条款及条件，在用户使用“通过 Google 预订”功能预订服务时显示。此外，这些集合商家合作伙伴的条款及条件会始终向用户显示，且不得在此提供。

string

不透明的字符串，用于在显示合作伙伴属性时标识面向消费者的品牌。此字段允许拥有多个面向消费者的品牌的合作伙伴在同一 Feed 中提供所有品牌的商家。

品牌由面向消费者的属性（例如名称、徽标、服务条款及隐私权政策）组成。

如果只有一个面向消费者的合作伙伴品牌，则无需设置该字段，且可将其忽略。

如果合作伙伴…

没有多个面向消费者的品牌？--> 请忽略此字段

配置了多个品牌？

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

请注意，大多数合作伙伴都不需要设置该字段。如果合作伙伴要使用该字段，必须先与我们联系以配置单独的品牌（包括默认品牌）。

object (MerchantMatchingHints)

可帮助 Google 将商家与 Google 地图上的地点进行匹配的提示。请注意：大多数合作伙伴都不需要设置该字段，因为 Google 会使用上述信息将商家与 Google 地图上的地点进行匹配。（可选）

object (ServiceAttribute)

用于描述此商家的服务的任何服务属性的定义。（可选）

object (ActionLink)

可选。一个操作网址，包含所用语言、支持的国家/地区列表、类型以及可选平台（表示应在哪个平台上执行此操作），

object (Advisement)

可选。特定商家针对用户通过“通过 Google 预订”功能加入等候名单提供的一般建议。建议中的各个文本字段的长度应限制为 100 字节。

object (EconomicOperator)

可选。与此特定商家相关联的经济运营商信息，以便遵从相关法规。（可选）

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object (CreditCardRestrictions)

对此商家所接受的信用卡的限制。如果未设置该字段，我们会默认接受所有信用卡。请注意，CreditCardType 支持的信用卡列表会随着时间的推移而扩展，这意味着将该字段留空可便于之后对配置进行更改。

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

受支持的信用卡列表。留空表示不支持任何信用卡。

{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}

string

此 ID 用于标识此付款方式。

此 ID 适用于所有集合商家，而且如果多个商家重复使用同一个值，则可允许用户在向这些商家付款时都可以使用相应的付款方式。

当多个商家重复使用某个 ID 时，更新某个商家所接受付款方式的任何值后，其他商家使用相同 ID 所标识的付款方式也会一并更新。因此，最好为所有付款方式使用同一 ID，并始终将其更新为相同的值，避免出现非确定性行为。

string

付款方式的名称。此信息可向用户显示。

string

付款方式的说明。此信息可向用户显示。

object (Price)

付款方式的价格。

object (TaxRate)

此付款方式的税率。如果设置该字段，则会替换在商家或服务中设置的 taxRate 字段。如果消息为空（即 taxRate { }），系统会将适用的税率重置为零。

enum (PaymentOptionType)

此付款方式的类型。适用于临时用户的一次性付款方式、适用于套餐的可多次使用的付款方式以及适用于会员的无使用次数限制的付款方式。

string (int64 format)

此付款方式可用于多少次会话。仅对多个会话 / 套餐有效，其值应大于 1。

object (TimeRange)

可在此时间范围内购买的付款方式。

object (TimeRange)

可在此时间范围内使用付款方式（例如，2017 年 1 月特惠价格）。如果设置该字段，则会替换 validDuration 和 activationType。

string (Duration format)

付款方式的有效期限（例如 30 天的会员资格有效期）。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

enum (ActivationType)

定义如何确定此付款方式的有效期开始日期。

object (UserPurchaseRestriction)

有资格购买此付款方式的用户需满足的限制条件。可用于将促销付款方式的限制为部分用户。如果未设置，则表示所有用户均符合条件。

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

只能由以前未从同一商家购买过付款方式的用户购买的付款方式。

boolean

只能由以前未购买过同一付款方式的用户购买的付款方式。

{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}

enum (Processor)

定义应用此配置所适用的付款处理方合作伙伴。

string

用于通过付款处理方识别此商家的密钥。

如需了解 Stripe，请访问 https://stripe.com/docs/dashboard#api-keys。如需了解 Braintree，请访问 https://articles.braintreepayments.com/control-panel/important-gateway-credentials

string

随付款请求一同发送给付款处理方的 API 版本号。

{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}

map (key: string, value: string)

令牌化配置通常会有一个 tokenizationParameter，其键为“gateway”，其值为处理方的名称。

其余参数取决于处理方。如需了解详情，请参阅 Google Pay 的文档。

Braintree 示例：tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe 示例：tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen 示例：tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

enum (BillingInformationFormat)

在付款令牌中添加用户在 Google Pay 中输入的结算信息（请参阅上文）。将该字段留空等同于指定 MIN。

{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}

string

（可选）指向条款及条件的网址。

string

将向用户显示的文字。请为新集成使用以下 localizedText。

object (Text)

将向用户显示的本地化文本。

{
  "placeId": string
}

string

Google Places 数据库中和 Google 地图上某个地点的地点 ID。如需详细了解地点 ID，请访问 https://developers.google.com/places/web-service/place-id。

{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}

string

一种标识符，用于唯一标识同一商家的此服务属性（例如“account-type”）。

string

此属性的用户可见名称，例如“账号类型”。

object (Value)

此服务属性的所有可能值。

{
  "valueId": string,
  "valueName": string
}

string

用于在此服务属性中唯一标识该值的标识符（例如“personal”）。

string

值的用户可见名称（例如“个人”）。

{
  "text": {
    object (Text)
  }
}

object (Text)

在用户使用“通过 Google 预订”功能进行预订时向其显示的自定义消息。

{
  "text": {
    object (Text)
  }
}

object (Text)

必需。经济运营者的姓名、地址、电话号码和电子邮件地址。经济运营者是指制造商、授权代表、进口商、分销商、履单服务提供商或任何其他负有与制造产品、提供产品或投入使用产品相关义务的自然人或法人。economicOperator 的自由格式字符串表示法。此信息可以使用“"”和“\n”进行格式设置。