REST Resource: accounts.termsOfServiceAgreementStates

리소스: termsOfServiceAgreementState

이 리소스는 지정된 계정 및 서비스 약관 종류의 계약 상태를 나타냅니다. 상태는 다음과 같습니다.

  • 판매자가 서비스 약관에 동의한 경우 수락됨이 표시되고 그렇지 않으면 비어 있습니다.
  • 판매자가 서비스 약관에 서명해야 하는 경우 required라고 입력되어 있고 그렇지 않으면 비어 있습니다.

필수 및 허용이 모두 있을 수 있습니다. 이 경우 accepted 서비스 약관의 validUntil 필드에 만료일이 설정되어 있습니다. 계정에서 유효한 계약을 계속 유지하려면 validUntil 전에 required 서비스 약관에 동의해야 합니다. 새로운 서비스 약관에 동의할 때 서드 파티는 해당 서비스 약관과 관련된 텍스트를 표시해야 합니다 (텍스트가 포함된 파일의 URL이 아래의 필수 메시지에 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

서비스 약관 파일의 전체 URL입니다. 이 필드는 TermsOfService.file_uri와 동일하며 편의를 위해 여기에 추가되었습니다.

메서드

get

 서비스 약관의 상태를 반환합니다.

retrieveForApplication

 애플리케이션 서비스 약관의 계약 상태를 검색합니다.