REST Resource: accounts.termsOfServiceAgreementStates

Risorsa: TermsOfServiceAgreementState

Questa risorsa rappresenta lo stato del contratto per un determinato account e tipo di Termini di servizio. Lo stato è il seguente:

  • Se il commerciante ha accettato i Termini di servizio, il valore accepted verrà inserito, altrimenti sarà vuoto
  • Se il commerciante deve firmare i Termini di servizio, il campo obbligatorio verrà compilato, altrimenti rimarrà vuoto.

Tieni presente che possono essere presenti sia required che accepted. In questo caso, i Termini di servizio di accepted avranno una data di scadenza impostata nel campo validUntil. I Termini di servizio di required devono essere accettati prima del giorno validUntil affinché il contratto dell'account rimanga valido. Quando accettano i nuovi Termini di servizio, ci aspettiamo che le terze parti mostrino il testo associato al contratto di servizio in questione (l'URL del file contenente il testo viene aggiunto nel messaggio obbligatorio di seguito come tosFileUri. L'accettazione effettiva dei Termini di servizio viene eseguita chiamando accept nella risorsa TermsOfService.

Rappresentazione JSON 
{
  "name": string,
  "regionCode": string,
  "termsOfServiceKind": enum (TermsOfServiceKind),
  "accepted": {
    object (Accepted)
  },
  "required": {
    object (Required)
  }
}
Campi
name

string

Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier} Il formato dell'identificatore è: {TermsOfServiceKind}-{country} Ad esempio, un identificatore potrebbe essere: MERCHANT_CENTER-US
regionCode

string

Codice regione come definito da https://cldr.unicode.org/. Si tratta del paese a cui si applica lo stato attuale.
termsOfServiceKind

enum (TermsOfServiceKind)

Tipo di Termini di servizio associati alla versione specifica.
accepted

object (Accepted)

I Termini di servizio accettati di questo tipo e per il regionCode associato
required

object (Required)

I Termini di servizio obbligatori

Accettato

Descrive i Termini di servizio accettati.

Rappresentazione JSON 
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
Campi
termsOfService

string

I termsOfService accettati.
acceptedBy

string

L'account in cui è stata registrata l'accettazione. Può trattarsi dell'account stesso o, nel caso dei subaccount, dell'account AMC.
validUntil

object (Date)

Se impostato, indica che i TermsOfService accettati sono validi solo fino alla fine di questa data (in UTC). Prima di questa data, ne deve essere accettata una nuova. Le informazioni relative a TermsOfService obbligatorie sono riportate nel messaggio Obbligatorio.

Obbligatorio

Descrive i Termini di servizio che devono essere accettati.

Rappresentazione JSON 
{
  "termsOfService": string,
  "tosFileUri": string
}
Campi
termsOfService

string

I termsOfService che devono essere accettati.
tosFileUri

string

URL completo del file dei Termini di servizio. Questo campo è uguale a TermsOfService.file_uri, ma è stato aggiunto qui solo per comodità.

Metodi

get

 Restituisce lo stato di un contratto con Termini di servizio.

retrieveForApplication

 Recupera lo stato del contratto per i Termini di servizio dell'applicazione.