REST Resource: accounts.termsOfServiceAgreementStates

리소스: TermsOfServiceAgreementState

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

  • 판매자가 서비스 약관에 동의한 경우 동의함이 채워지고 그렇지 않은 경우 비워집니다.
  • 판매자가 서비스 약관에 서명해야 하는 경우 required가 채워지고 그렇지 않으면 비어 있습니다.

required와 accepted가 모두 있을 수 있습니다. 이 경우 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

 애플리케이션 서비스 약관에 대한 동의 상태를 가져옵니다.