REST Resource: accounts.termsOfServiceAgreementStates

Ressource: TermsOfServiceAgreementState

Diese Ressource stellt den Status der Vereinbarung für ein bestimmtes Konto und eine bestimmte Art von Nutzungsbedingungen dar. Der Status ist:

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

Sowohl required als auch accepted können vorhanden sein. In diesem Fall wird für die accepted-Nutzungsbedingungen im Feld validUntil ein Ablaufdatum festgelegt. Die required-Nutzungsbedingungen müssen vor dem validUntil akzeptiert werden, damit für das Konto weiterhin eine gültige Vereinbarung besteht. Wenn neue Nutzungsbedingungen akzeptiert werden, erwarten wir, dass Drittanbieter den Text anzeigen, der mit der entsprechenden Nutzungsvereinbarung verknüpft ist. Die URL der Datei mit dem Text wird unten in der erforderlichen Nachricht als tosFileUri hinzugefügt. Die tatsächliche Akzeptanz der Nutzungsbedingungen erfolgt durch Aufrufen von „accept“ auf 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 Nutzungsbedingungenversion. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Das Format der Kennung ist: {TermsOfServiceKind}-{country} Eine Kennung kann beispielsweise so aussehen: MERCHANT_CENTER-US
regionCode

string

Regionscode gemäß https://cldr.unicode.org/. Das Land, für das der aktuelle Status gilt.
termsOfServiceKind

enum (TermsOfServiceKind)

Art der Nutzungsbedingungen, die mit der jeweiligen Version verknüpft ist.
accepted

object (Accepted)

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

object (Required)

Die erforderlichen Nutzungsbedingungen

Akzeptiert

Beschreibung der akzeptierten Nutzungsbedingungen.

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

string

Die akzeptierten termsOfService.
acceptedBy

string

Das Konto, in dem die Annahme erfasst wurde. Das kann das Konto selbst oder, im Fall von Unterkonten, das Mehrfachkundenkonto sein.
validUntil

object (Date)

Wenn dieser Parameter festgelegt ist, gilt, dass die akzeptierten TermsOfService nur bis zum Ende dieses Datums (in UTC) gültig sind. Bis dahin muss eine neue Vereinbarung akzeptiert werden. Die Informationen zu den erforderlichen TermsOfService finden Sie in der Meldung Required (Erforderlich).

Erforderlich

Hier werden die Nutzungsbedingungen beschrieben, die akzeptiert werden müssen.

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

string

Die termsOfService, die akzeptiert werden müssen.
tosFileUri

string

Vollständige URL zur Datei mit den Nutzungsbedingungen. Dieses Feld ist mit TermsOfService.file_uri identisch und wird hier nur der Übersichtlichkeit halber hinzugefügt.

Methoden

get

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

retrieveForApplication

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