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}ID 格式為:{TermsOfServiceKind}-{country}。舉例來說,ID 可能為: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 僅在此日期結束 (世界標準時間) 為止。你必須在上述日期前接受新的 PIN 碼。您可以在「必要」訊息中找到必要 TermsOfService 資訊。

必填

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

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

string

需接受的 termsOfService

tosFileUri

string

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

方法

get

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

retrieveForApplication

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