REST Resource: accounts.termsOfServiceAgreementStates

資源：TermsOfServiceAgreementState

這項資源代表指定帳戶的協議狀態和服務條款類型。狀態如下所示：

  • 如果商家已接受服務條款：系統會填入「已接受」，否則其中會留空
  • 如果商家必須簽署服務條款：系統會填入「必要」，否則系統會留空。

請注意，您可以同時顯示必填和接受兩種屬性。在這種情況下，accepted 服務條款的到期日為 validUntil 欄位中。您必須在 validUntil前接受「required」的服務條款，帳戶才能繼續簽訂有效協議。接受新的服務條款時，我們希望第三方顯示與指定服務條款協議相關的文字 (內含文字的檔案所在檔案的網址會在下方的「必要訊息」中新增為 tosFileUri)。您只需在 TermsOfService 資源上呼叫接受，即可確實接受服務條款。

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

string

ID。服務條款版本的資源名稱。格式：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 僅在此日期結束 (世界標準時間) 為止。你必須在上述日期前接受新的 PIN 碼。您可以在「必要」訊息中找到必要 TermsOfService 資訊。

需要

說明必須接受的服務條款。

JSON 表示法 
{
  "termsOfService": string,
  "tosFileUri": string
}
欄位
termsOfService

string

需接受的 termsOfService。
tosFileUri

string

服務條款檔案的完整網址。這個欄位與 TermsOfService.file_uri 相同，只是為了方便起見，這裡新增。

方法

get

 傳回服務條款協議的狀態。

retrieveForApplication

 擷取應用程式服務條款的協議狀態。