REST Resource: termsOfService

Risorsa: Termini di servizio

Il messaggio TermsOfService indica una versione specifica dei Termini di servizio che i commercianti devono accettare per accedere a determinate funzionalità o servizi (vedi https://support.google.com/merchants/answer/160173).

Questo messaggio è importante per la procedura di onboarding, in quanto garantisce che i commercianti accettino i contratti legali necessari per l'utilizzo del servizio. I commercianti possono recuperare i Termini di servizio più recenti per un determinato kind e region tramite termsOfService.retrieveLatest e accettarli come richiesto tramite termsOfService.accept.

Rappresentazione JSON 
{
  "name": string,
  "regionCode": string,
  "kind": enum (TermsOfServiceKind),
  "external": boolean,
  "fileUri": string
}
Campi
name

string

Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: termsOfService/{version}
regionCode

string

Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese o 001 quando lo stesso TermsOfService può essere firmato in qualsiasi paese. Tuttavia, tieni presente che, quando firmi un TdS che si applica a livello globale, ci aspettiamo comunque che venga fornito un paese specifico (dovrebbe essere il paese in cui ha sede l'attività commerciale del commerciante o il paese di partecipazione al programma).
kind

enum (TermsOfServiceKind)

Il tipo a cui si applica questa versione dei Termini di servizio.
external

boolean

Indica se questa versione dei Termini di servizio è esterna. Le versioni dei Termini di servizio esterni possono essere accettate solo tramite procedure esterne e non direttamente dal commerciante tramite UI o API.
fileUri

string

URI del file dei Termini di servizio che deve essere mostrato agli utenti che li firmano.

Metodi

accept

 Accetta un TermsOfService.

get

 Recupera il TermsOfService associato alla versione fornita.

retrieveLatest

 Recupera la versione più recente del TermsOfService per un determinato kind e region_code.