REST Resource: accounts.termsOfServiceAgreementStates

Recurso: TermsOfServiceAgreementState

Esse recurso representa o estado do contrato de uma determinada conta e os tipos de termos de serviço. O estado é o seguinte:

  • Se o comerciante aceitou os Termos de Serviço: aceito será preenchido. Caso contrário, ele vai estar vazio
  • Se o comerciante precisar assinar os Termos de Serviço: obrigatório será preenchido. Caso contrário, ele vai ficar vazio.

Tanto required quanto accepted podem estar presentes. Nesse caso, os termos de serviço accepted terão uma data de validade definida no campo validUntil. Os Termos de Serviço do required precisam ser aceitos antes de validUntil para que a conta continue com um acordo válido. Ao aceitar novos Termos de Serviço, esperamos que os terceiros mostrem o texto associado ao contrato de Termos de Serviço. O URL do arquivo que contém o texto é adicionado à mensagem obrigatória abaixo como tosFileUri. A aceitação real dos Termos de Serviço é feita chamando "accept" no recurso TermsOfService.

Representação JSON
{
  "name": string,
  "regionCode": string,
  "termsOfServiceKind": enum (TermsOfServiceKind),
  "accepted": {
    object (Accepted)
  },
  "required": {
    object (Required)
  }
}
Campos
name

string

Identificador. O nome do recurso da versão dos Termos de Serviço. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier} O formato do identificador é {TermsOfServiceKind}-{country}. Por exemplo, um identificador pode ser MERCHANT_CENTER-US.

regionCode

string

Código regional, conforme definido em https://cldr.unicode.org/. País a que o estado atual se aplica.

termsOfServiceKind

enum (TermsOfServiceKind)

Termos de Serviço associados à versão específica.

accepted

object (Accepted)

Os termos de serviço aceitos desse tipo e para o regionCode associado

required

object (Required)

Os Termos de Serviço necessários

Aceito

Descreve os Termos de Serviço aceitos.

Representação JSON
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
Campos
termsOfService

string

Os termsOfService aceitos.

acceptedBy

string

A conta em que a aceitação foi registrada. Pode ser a própria conta ou, no caso de subcontas, a conta de MCA.

validUntil

object (Date)

Quando definido, indica que os TermsOfService aceitos são válidos apenas até o fim dessa data (em UTC). Uma nova precisa ser aceita antes disso. As informações dos TermsOfService obrigatórios estão na mensagem Obrigatório.

Obrigatório

Descreve os Termos de Serviço que precisam ser aceitos.

Representação JSON
{
  "termsOfService": string,
  "tosFileUri": string
}
Campos
termsOfService

string

Os termsOfService que precisam ser aceitos.

tosFileUri

string

URL completo do arquivo dos Termos de Serviço. Esse campo é igual a TermsOfService.file_uri e foi adicionado aqui apenas para sua conveniência.

Métodos

get

Retorna o estado de um contrato de Termos de Serviço.

retrieveForApplication

Recupera o estado do acordo para os Termos de Serviço do aplicativo.