REST Resource: accounts.termsOfServiceAgreementStates

資源：TermsOfServiceAgreementState

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

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

請注意，required 和 accepted 都可能出現在同一行。在這種情況下，accepted 服務條款的到期日會設在 validUntil 欄位中。required 服務條款必須在 validUntil 前接受，帳戶才能繼續擁有有效的合約。接受新服務條款時，我們希望第三方顯示與特定服務條款協議相關聯的文字 (包含文字的檔案網址已在下方必要訊息中新增為 tosFileUri)。您可以對 TermsOfService 資源呼叫 accept，實際接受服務條款。

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

string

ID。服務條款版本的資源名稱。格式：accounts/{account}/termsOfServiceAgreementState/{identifier} ID 格式為：{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 僅在該日期 (以世界標準時間為準) 結束前有效。屆時必須接受新的政策。您可以在「Required」訊息中找到必要的 TermsOfService 資訊。

必填

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

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

string

需要接受的 termsOfService。
tosFileUri

string

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

方法

get

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

retrieveForApplication

 擷取應用程式服務條款的同意狀態。