REST Resource: accounts.termsOfServiceAgreementStates

Ressource: TermsOfServiceAgreementState

Diese Ressource stellt den Vereinbarungsstatus für ein bestimmtes Konto und die Art der Nutzungsbedingungen dar. Der Status lautet wie folgt:

  • Wenn der Händler die Nutzungsbedingungen akzeptiert hat, wird accepted ausgefüllt. Andernfalls ist das Feld leer.
  • Wenn der Händler die Nutzungsbedingungen unterzeichnen muss, wird required (erforderlich) ausgefüllt. Andernfalls ist das Feld leer.

Es können sowohl erforderlich als auch akzeptiert vorhanden sein. In diesem Fall ist für die accepted-Nutzungsbedingungen ein Ablaufdatum im Feld validUntil festgelegt. Die required-Nutzungsbedingungen müssen vor dem validUntil akzeptiert werden, damit für das Konto weiterhin eine gültige Vereinbarung besteht. Wenn Drittanbieter die neuen Nutzungsbedingungen akzeptieren, müssen sie den Text anzeigen, der mit der vorliegenden Vereinbarung zu den Nutzungsbedingungen verknüpft ist. Die URL zu der Datei mit dem Text wird der erforderlichen Nachricht unten als tosFileUri hinzugefügt. Die tatsächliche Annahme der Nutzungsbedingungen erfolgt durch Aufrufen von Accept in der Ressource TermsOfService.

JSON-Darstellung 
{
  "name": string,
  "regionCode": string,
  "termsOfServiceKind": enum (TermsOfServiceKind),
  "accepted": {
    object (Accepted)
  },
  "required": {
    object (Required)
  }
}
Felder
name

string

Kennung. Der Ressourcenname der Version der Nutzungsbedingungen. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Das Format der Kennung ist {TermsOfServiceKind}-{country}. Eine Kennzeichnung könnte beispielsweise so aussehen: MERCHANT_CENTER-US
regionCode

string

Regionscode gemäß der Definition in https://cldr.unicode.org/. Dies ist das Land, für das der aktuelle Bundesstaat gilt.
termsOfServiceKind

enum (TermsOfServiceKind)

Die Art der Nutzungsbedingungen, die der jeweiligen Version zugeordnet sind.
accepted

object (Accepted)

Die akzeptierten Nutzungsbedingungen dieser Art und für den zugehörigen „regionCode“
required

object (Required)

Die erforderlichen Nutzungsbedingungen

Angenommen

Beschreibt die akzeptierten Nutzungsbedingungen.

JSON-Darstellung 
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
Felder
termsOfService

string

Die akzeptierten termsOfService.
acceptedBy

string

Das Konto, über das die Zustimmung aufgezeichnet wurde. Dies kann das Konto selbst oder, im Fall von Unterkonten, das MCA-Konto sein.
validUntil

object (Date)

Wenn festgelegt, wird darin angegeben, dass die akzeptierten TermsOfService nur bis zum Ende dieses Datums (in UTC) gültig sind. Bis dahin muss eine neue akzeptiert werden. Die Informationen zu den erforderlichen TermsOfService finden Sie in der Nachricht Required (Erforderlich).

Erforderlich

Beschreibt die Nutzungsbedingungen, die akzeptiert werden müssen.

JSON-Darstellung 
{
  "termsOfService": string,
  "tosFileUri": string
}
Felder
termsOfService

string

Die termsOfService (Nutzungsbedingungen), die akzeptiert werden müssen.
tosFileUri

string

Vollständige URL zur Datei mit den Nutzungsbedingungen. Dieses Feld ist mit TermsOfService.file_uri identisch. Es wurde hier nur der Einfachheit halber hinzugefügt.

Methoden

get

 Gibt den Status einer Vereinbarung über Nutzungsbedingungen zurück.

retrieveForApplication

 Ruft den Status der Vereinbarung für die Nutzungsbedingungen der Anwendung ab.