- [Resource: TermsOfServiceAgreementState](https://developers.google.com/merchant/api/reference/rest/accounts_v1alpha/accounts.termsOfServiceAgreementStates.md.txt#TermsOfServiceAgreementState)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/accounts_v1alpha/accounts.termsOfServiceAgreementStates.md.txt#TermsOfServiceAgreementState.SCHEMA_REPRESENTATION)
- [Accepted](https://developers.google.com/merchant/api/reference/rest/accounts_v1alpha/accounts.termsOfServiceAgreementStates.md.txt#Accepted)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/accounts_v1alpha/accounts.termsOfServiceAgreementStates.md.txt#Accepted.SCHEMA_REPRESENTATION)
- [Required](https://developers.google.com/merchant/api/reference/rest/accounts_v1alpha/accounts.termsOfServiceAgreementStates.md.txt#Required)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/accounts_v1alpha/accounts.termsOfServiceAgreementStates.md.txt#Required.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/merchant/api/reference/rest/accounts_v1alpha/accounts.termsOfServiceAgreementStates.md.txt#METHODS_SUMMARY)

## Resource: TermsOfServiceAgreementState

This resource represents the agreement state for a given account and terms of service kind. The state is as follows:

- If the business has accepted a terms of service, `` `accepted` `` will be populated, otherwise it will be empty
- If the business must sign a terms of service, `` `required` `` will be populated, otherwise it will be empty.

Note that both `required` and `accepted` can be present. In this case the `accepted` terms of services will have an expiration date set in the `` `validUntil` `` field. The `required` terms of services need to be accepted before `validUntil` in order for the account to continue having a valid agreement. When accepting new terms of services we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `` `tosFileUri` ``). The actual acceptance of the terms of service is done by calling accept on the `` `TermsOfService` `` resource. `validUntil` field.

For more information, see [Manage Terms of Service](https://developers.google.com/merchant/api/guides/accounts/manage-tos-agreements.md.txt).

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

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementState/{identifier}` The identifier format is: `{[TermsOfServiceKind][google.shopping.merchant.accounts.v1alpha.TermsOfServiceKind]}-{country}` For example, an identifier could be: `MERCHANT_CENTER-EU` or `MERCHANT_CENTER-US`. |
| `regionCode` | `string` Required. Region code as defined by <https://cldr.unicode.org/>. This is the country the current state applies to. |
| `termsOfServiceKind` | ``enum (`TermsOfServiceKind`)`` Required. Terms of Service kind associated with the particular version. |
| `accepted` | ``object (`Accepted`)`` Optional. The accepted terms of service of this kind and for the associated regionCode |
| `required` | ``object (`Required`)`` Optional. The required terms of service |

## Accepted

Describes the [accepted terms of service](https://developers.google.com/merchant/api/guides/accounts/manage-tos-agreements.md.txt#accept-tos).

| JSON representation |
|---|
| ``` { "termsOfService": string, "acceptedBy": string, "validUntil": { object (`Date`) } } ``` |

| Fields ||
|---|---|
| `termsOfService` | `string` Required. The accepted `termsOfService`. |
| `acceptedBy` | `string` Required. The account where the acceptance was recorded. This can be the account itself or, in the case of subaccounts, the advanced account. |
| `validUntil` | ``object (`Date`)`` Optional. When set, it states that the accepted `TermsOfService` is only valid until the end of this date (in UTC). A new one must be accepted before then. The information of the required `TermsOfService` is found in the `Required` message. |

## Required

Describes the terms of service which are required to be accepted.

| JSON representation |
|---|
| ``` { "termsOfService": string, "tosFileUri": string } ``` |

| Fields ||
|---|---|
| `termsOfService` | `string` Required. The `TermsOfService` that need to be accepted. |
| `tosFileUri` | `string` Required. Full URL to the terms of service file. This field is the same as `TermsOfService.file_uri`, it is added here for convenience only. |

| ## Methods ||
|---|---|
| ### `get` | Returns the state of a terms of service agreement. |
| ### `retrieveForApplication` | Retrieves the state of the agreement for the application terms of service. |