REST Resource: accounts.termsOfServiceAgreementStates

资源：TermsOfServiceAgreementState

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

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

请注意，可以同时提供 required 和 accepted 这两个字段。在这种情况下，系统会在 validUntil 字段中设置 accepted 服务条款的到期日期。您必须在 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}
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

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