REST Resource: accounts.termsOfServiceAgreementStates

资源:TermsOfServiceAgreementState

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

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

请注意,可以同时提供 requiredaccepted 这两个字段。在这种情况下,accepted 服务条款会在 validUntil 字段中设置失效日期。您必须在 validUntil之前接受《required》服务条款,此账号才会继续签署有效的协议。在接受新的服务条款时,我们希望第三方显示与指定服务条款协议相关的文本(包含该文本的文件的网址作为 tosFileUri 添加到下面的必要消息中)。对 TermsOfService 资源调用 accept 即可实际接受服务条款。

JSON 表示法
{
  "name": string,
  "regionCode": string,
  "termsOfServiceKind": enum (TermsOfServiceKind),
  "accepted": {
    object (Accepted)
  },
  "required": {
    object (Required)
  }
}
字段
name

string

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

regionCode

string

https://cldr.unicode.org/ 定义的地区代码。这是指当前州所适用的国家/地区。

termsOfServiceKind

enum (TermsOfServiceKind)

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

accepted

object (Accepted)

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

required

object (Required)

所需的服务条款

已接受

说明已接受的服务条款。

JSON 表示法
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
字段
termsOfService

string

接受的 termsOfService

acceptedBy

string

用于记录接受操作的账号。这可以是账号本身;如果是子账号,也可以是 MCA 账号。

validUntil

object (Date)

设置后,它会声明接受的 TermsOfService 仅在此日期(采用世界协调时间)结束之前有效。您必须在该日期之前接受新的付款方式。您可以在必需消息中找到所需 TermsOfService 的信息。

必填

用于说明需要接受的服务条款。

JSON 表示法
{
  "termsOfService": string,
  "tosFileUri": string
}
字段
termsOfService

string

需要接受的 termsOfService

tosFileUri

string

指向服务条款文件的完整网址。此字段与 TermsOfService.file_uri 相同,在此添加只是为了方便起见。

方法

get

返回服务条款协议的状态。

retrieveForApplication

检索应用服务条款的协议状态。