REST Resource: accounts.termsOfServiceAgreementStates

资源：TermsOfServiceAgreementState

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

  • 如果商家已接受服务条款：系统会填充 accepted，否则将为空
  • 如果商家必须签署服务条款，系统会填充“必填”，否则将留空。

请注意，必需和接受均可存在。在这种情况下，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仅在该日期结束之前有效（以 UTC 时间为准）。您必须在该日期之前接受新的合作伙伴协议。您可以在必需消息中找到必需的 TermsOfService 信息。

必填

说明必须接受的服务条款。

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

string

需要接受的termsOfService。
tosFileUri

string

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

方法

get

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

retrieveForApplication

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