REST Resource: accounts.termsOfServiceAgreementStates

リソース: TermsOfServiceAgreementState

このリソースは、特定のアカウントと利用規約の種類の同意状態を表します。状態は次のとおりです。

  • 販売者が利用規約に同意している場合: [accepted] が入力されます。同意していない場合は空白になります
  • 販売者が利用規約に署名する必要がある場合は [必須] が入力されます。それ以外の場合は空白になります。

必須承認済みの両方を指定できます。この場合、accepted 利用規約の validUntil フィールドに有効期限が設定されます。アカウントの有効な契約を継続するには、validUntil より前に required 利用規約に同意する必要があります。新しい利用規約に同意する際に、サードパーティは、特定の利用規約に関連付けられたテキストを表示する必要があります(テキストを含むファイルの URL は、下記の必須メッセージに tosFileUri として追加されます。利用規約の実際の承認は、TermsOfService リソースで accept を呼び出すことによって行われます。

JSON 表現
{
  "name": string,
  "regionCode": string,
  "termsOfServiceKind": enum (TermsOfServiceKind),
  "accepted": {
    object (Accepted)
  },
  "required": {
    object (Required)
  }
}
フィールド
name

string

ID。利用規約のバージョンのリソース名。形式: accounts/{account}/termsOfServiceAgreementState/{identifier} 識別子の形式は {TermsOfServiceKind}-{country} です。識別子の例: MERCHANT_CENTER-US

regionCode

string

https://cldr.unicode.org/ で定義されている地域コード。現在の状態が適用される国です。

termsOfServiceKind

enum (TermsOfServiceKind)

特定のバージョンに関連付けられている利用規約の種類。

accepted

object (Accepted)

この種類と関連する regionCode で承認されている利用規約

required

object (Required)

必要な利用規約

承認済み

同意した利用規約を説明します。

JSON 表現
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
フィールド
termsOfService

string

同意済みのtermsOfService

acceptedBy

string

承認が記録されたアカウント。アカウント自体でも、サブアカウントの場合は MCA アカウントでもかまいません。

validUntil

object (Date)

設定すると、同意したTermsOfService はこの日付(UTC)の終了日まで有効であると明記されます。期限までに新しいポリシーに同意する必要があります。必須の TermsOfService の情報は、[必須] メッセージに表示されます。

必須

同意が必要な利用規約を説明します。

JSON 表現
{
  "termsOfService": string,
  "tosFileUri": string
}
フィールド
termsOfService

string

同意が必要な termsOfService

tosFileUri

string

利用規約ファイルの完全な URL。このフィールドは TermsOfService.file_uri と同じです。便宜上ここに追加されています。

メソッド

get

利用規約の状態を返します。

retrieveForApplication

アプリケーションの利用規約の同意の状態を取得します。