google-api-python-client 2.168.0__py3-none-any.whl → 2.170.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json

@@ -233,7 +233,7 @@
 "type": "string"
 },
 "provider": {
-"description": "Required. The aggregation service provider. Format: `providers/{providerId}`",
+"description": "Required. The aggregation service provider. Format: `accounts/{accountId}`",
 "location": "path",
 "pattern": "^accounts/[^/]+$",
 "required": true,
@@ -602,7 +602,7 @@
 "homepage": {
 "methods": {
 "claim": {
-"description": "Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message will be returned: * PERMISSION_DENIED: user doesn't have the necessary permissions on this MC account; * FAILED_PRECONDITION: - The account is not a Merchant Center account; - MC account doesn't have a homepage; - claiming failed (in this case the error message will contain more details).",
+"description": "Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message is returned: * PERMISSION_DENIED: User doesn't have the necessary permissions on this Merchant Center account. * FAILED_PRECONDITION: - The account is not a Merchant Center account. - Merchant Center account doesn't have a homepage. - Claiming failed (in this case the error message contains more details).",
 "flatPath": "accounts/v1beta/accounts/{accountsId}/homepage:claim",
 "httpMethod": "POST",
 "id": "merchantapi.accounts.homepage.claim",
@@ -721,7 +721,7 @@
 "issues": {
 "methods": {
 "list": {
-"description": "Lists all account issues of a Merchant Center account.",
+"description": "Lists all account issues of a Merchant Center account. When called on a multi-client account, this method only returns issues belonging to that account, not its sub-accounts. To retrieve issues for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.issues.list` for each sub-account individually.",
 "flatPath": "accounts/v1beta/accounts/{accountsId}/issues",
 "httpMethod": "GET",
 "id": "merchantapi.accounts.issues.list",
@@ -1111,6 +1111,254 @@
 }
 }
 },
+"relationships": {
+"methods": {
+"get": {
+"description": "Retrieve an account relationship.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/relationships/{relationshipsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.relationships.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account relationship to get. Format: `accounts/{account}/relationships/{relationship}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/relationships/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+name}",
+"response": {
+"$ref": "AccountRelationship"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "List account relationships for the specified account.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/relationships",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.relationships.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of elements to return in the response. Use for paging. If no `page_size` is specified, `100` is used as the default value. The maximum allowed value is `1000`.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. The token returned by the previous `list` request.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent account of the account relationship to filter by. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+parent}/relationships",
+"response": {
+"$ref": "ListAccountRelationshipsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates the account relationship. Executing this method requires admin access.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/relationships/{relationshipsId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.relationships.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/relationships/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `account_id_alias`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+name}",
+"request": {
+"$ref": "AccountRelationship"
+},
+"response": {
+"$ref": "AccountRelationship"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"services": {
+"methods": {
+"approve": {
+"description": "Approve an account service proposal.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/services/{servicesId}:approve",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.services.approve",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account service to approve. Format: `accounts/{account}/services/{service}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/services/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+name}:approve",
+"request": {
+"$ref": "ApproveAccountServiceRequest"
+},
+"response": {
+"$ref": "AccountService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieve an account service.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/services/{servicesId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.services.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account service to get. Format: `accounts/{account}/services/{service}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/services/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+name}",
+"response": {
+"$ref": "AccountService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "List account services for the specified accounts. Supports filtering.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/services",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.services.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of elements to return in the response. Use for paging. If no `page_size` is specified, `100` is used as the default value. The maximum allowed value is `1000`.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. The token returned by the previous `list` request.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent account of the account service to filter by. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+parent}/services",
+"response": {
+"$ref": "ListAccountServicesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"propose": {
+"description": "Propose an account service.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/services:propose",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.services.propose",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The resource name of the parent account for the service. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+parent}/services:propose",
+"request": {
+"$ref": "ProposeAccountServiceRequest"
+},
+"response": {
+"$ref": "AccountService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"reject": {
+"description": "Reject an account service (both proposed and approve services can be rejected).",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/services/{servicesId}:reject",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.services.reject",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account service to reject. Format: `accounts/{account}/services/{service}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/services/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+name}:reject",
+"request": {
+"$ref": "RejectAccountServiceRequest"
+},
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
 "shippingSettings": {
 "methods": {
 "getShippingSettings": {
@@ -1386,7 +1634,7 @@
 "accept": {
 "description": "Accepts a `TermsOfService`. Executing this method requires admin access.",
 "flatPath": "accounts/v1beta/termsOfService/{termsOfServiceId}:accept",
-"httpMethod": "GET",
+"httpMethod": "POST",
 "id": "merchantapi.termsOfService.accept",
 "parameterOrder": [
 "name"
@@ -1412,7 +1660,7 @@
 },
 "path": "accounts/v1beta/{+name}:accept",
 "response": {
-"$ref": "Empty"
+"$ref": "AcceptTermsOfServiceResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/content"
@@ -1480,9 +1728,20 @@
 }
 }
 },
-"revision": "20250416",
+"revision": "20250507",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
+"AcceptTermsOfServiceResponse": {
+"description": "Response message for the `AcceptTermsOfService` method.",
+"id": "AcceptTermsOfServiceResponse",
+"properties": {
+"termsOfServiceAgreementState": {
+"$ref": "TermsOfServiceAgreementState",
+"description": "The agreement state after accepting the ToS."
+}
+},
+"type": "object"
+},
 "Accepted": {
 "description": "Describes the accepted terms of service.",
 "id": "Accepted",
@@ -1492,7 +1751,7 @@
 "type": "string"
 },
 "termsOfService": {
-"description": "The accepted [termsOfService](google.shopping.merchant.accounts.v1main.TermsOfService).",
+"description": "The accepted termsOfService.",
 "type": "string"
 },
 "validUntil": {
@@ -1592,6 +1851,97 @@
 },
 "type": "object"
 },
+"AccountManagement": {
+"description": "`AccountManagement` payload.",
+"id": "AccountManagement",
+"properties": {},
+"type": "object"
+},
+"AccountRelationship": {
+"description": "The `AccountRelationship` message defines a formal connection between a merchant's account and a service provider's account. This relationship enables the provider to offer specific services to the merchant, such as product management or campaign management. It specifies the access rights and permissions to the merchant's data relevant to those services. Establishing an account relationship involves linking the merchant's account with a provider's account. The provider could be another Google account (like Google Ads or Google My Business) or a third-party platform (such as Shopify or WooCommerce).",
+"id": "AccountRelationship",
+"properties": {
+"accountIdAlias": {
+"description": "Optional. An optional alias you can assign to this account relationship. This alias acts as a convenient identifier for your own reference and management. It must be unique among all your account relationships with the same provider. For example, you might use `account_id_alias` to assign a friendly name to this relationship for easier identification in your systems.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`",
+"type": "string"
+},
+"provider": {
+"description": "Immutable. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).",
+"type": "string"
+},
+"providerDisplayName": {
+"description": "Output only. The human-readable display name of the provider account.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"AccountService": {
+"description": "The `AccountService` message represents a specific service that a provider account offers to a merchant account. `AccountService` defines the permissions and capabilities granted to the provider, allowing for operations such as product management or campaign management. The lifecycle of an `AccountService` involves a proposal phase, where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties by ensuring that access rights are granted appropriately and that both the merchant and provider are aware of the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen automatically. The mutability of a service is also managed through `AccountService`. Some services might be immutable, for example, if they were established through other systems or APIs, and you cannot alter them through this API.",
+"id": "AccountService",
+"properties": {
+"accountAggregation": {
+"$ref": "AccountAggregation",
+"description": "Service type for account aggregation. This enables the provider, which is a Multi-Client Account (MCA), to manage multiple sub-accounts (client accounts). Through this service, the MCA provider can perform administrative and operational tasks across all linked sub-accounts. This is useful for agencies, aggregators, or large retailers that need centralized control over many merchant accounts."
+},
+"accountManagement": {
+"$ref": "AccountManagement",
+"description": "Service type for account management. Enables the provider to perform administrative actions on the merchant's account, such as configuring account settings, managing users, or updating business information."
+},
+"campaignsManagement": {
+"$ref": "CampaignsManagement",
+"description": "Service type for managing advertising campaigns. Grants the provider access to create and manage the merchant's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance."
+},
+"externalAccountId": {
+"description": "Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions \u2014 the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.",
+"type": "string"
+},
+"handshake": {
+"$ref": "Handshake",
+"description": "Output only. Information about the state of the service in terms of establishing it (e.g. is it pending approval or approved).",
+"readOnly": true
+},
+"mutability": {
+"description": "Output only. Whether the service is mutable (e.g. through Approve / Reject RPCs). A service that was created through another system or API might be immutable.",
+"enum": [
+"MUTABILITY_UNSPECIFIED",
+"MUTABLE",
+"IMMUTABLE"
+],
+"enumDescriptions": [
+"Unused default value",
+"The service can be mutated without restrictions.",
+"The service is read-only and must not be mutated."
+],
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the account service. Format: `accounts/{account}/services/{service}`",
+"type": "string"
+},
+"productsManagement": {
+"$ref": "ProductsManagement",
+"description": "Service type for managing products. This allows the provider to handle product data on behalf of the merchant, including reading and writing product listings. It's commonly used when the provider offers inventory management or catalog synchronization services to keep the merchant's product information up-to-date across platforms."
+},
+"provider": {
+"description": "Output only. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).",
+"readOnly": true,
+"type": "string"
+},
+"providerDisplayName": {
+"description": "Output only. The human-readable display name of the provider account.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "AddAccountService": {
 "description": "Additional instructions to add account services during creation of the account.",
 "id": "AddAccountService",
@@ -1649,6 +1999,12 @@
 },
 "type": "object"
 },
+"ApproveAccountServiceRequest": {
+"description": "Request to approve an account service.",
+"id": "ApproveAccountServiceRequest",
+"properties": {},
+"type": "object"
+},
 "AutofeedSettings": {
 "description": "Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.",
 "id": "AutofeedSettings",
@@ -1872,6 +2228,12 @@
 },
 "type": "object"
 },
+"CampaignsManagement": {
+"description": "`CampaignManagement` payload.",
+"id": "CampaignsManagement",
+"properties": {},
+"type": "object"
+},
 "CarrierRate": {
 "description": "A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.",
 "id": "CarrierRate",
@@ -1908,7 +2270,7 @@
 "id": "ClaimHomepageRequest",
 "properties": {
 "overwrite": {
-"description": "Optional. When set to `true`, this option removes any existing claim on the requested website and replaces it with a claim from the account that makes the request.",
+"description": "Optional. When set to `true`, this option removes any existing claim on the requested website from any other account to the account making the request, effectively replacing the previous claim.",
 "type": "boolean"
 }
 },
@@ -2184,6 +2546,45 @@
 },
 "type": "object"
 },
+"Handshake": {
+"description": "The current status of establishing of the service. (for example, pending approval or approved).",
+"id": "Handshake",
+"properties": {
+"actor": {
+"description": "Output only. The most recent account to modify the account service's `approval_status`.",
+"enum": [
+"ACTOR_UNSPECIFIED",
+"ACCOUNT",
+"OTHER_PARTY"
+],
+"enumDescriptions": [
+"Unspecified actor.",
+"The last change was done by the account who has this service.",
+"The last change was done by the other party who this service points to."
+],
+"readOnly": true,
+"type": "string"
+},
+"approvalState": {
+"description": "Output only. The approval state of this handshake.",
+"enum": [
+"APPROVAL_STATE_UNSPECIFIED",
+"PENDING",
+"ESTABLISHED",
+"REJECTED"
+],
+"enumDescriptions": [
+"Unspecified approval status.",
+"The service was proposed and is waiting to be confirmed.",
+"Both parties have confirmed the service.",
+"The service proposal was rejected."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "Headers": {
 "description": "A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set.",
 "id": "Headers",
@@ -2427,6 +2828,42 @@ false
 },
 "type": "object"
 },
+"ListAccountRelationshipsResponse": {
+"description": "Response after trying to list account relationships.",
+"id": "ListAccountRelationshipsResponse",
+"properties": {
+"accountRelationships": {
+"description": "The account relationships that match your filter.",
+"items": {
+"$ref": "AccountRelationship"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A page token. You can send the `page_token` to get the next page. Only included in the `list` response if there are more pages.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListAccountServicesResponse": {
+"description": "Response after trying to list account services.",
+"id": "ListAccountServicesResponse",
+"properties": {
+"accountServices": {
+"description": "The account services that match your filter.",
+"items": {
+"$ref": "AccountService"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A page token. You can send the `page_token` to get the next page. Only included in the `list` response if there are more pages.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ListAccountsResponse": {
 "description": "Response message for the `ListAccounts` method.",
 "id": "ListAccountsResponse",
@@ -2614,11 +3051,11 @@ false
 "id": "OnlineReturnPolicy",
 "properties": {
 "acceptDefectiveOnly": {
-"description": "This field specifies if merchant only accepts defective products for returns, and this field is required.",
+"description": "Optional. This field specifies if merchant only accepts defective products for returns.",
 "type": "boolean"
 },
 "acceptExchange": {
-"description": "This field specifies if merchant allows customers to exchange products, this field is required.",
+"description": "Optional. This field specifies if merchant allows customers to exchange products.",
 "type": "boolean"
 },
 "countries": {
@@ -2658,7 +3095,7 @@ false
 "description": "Optional. The return policy."
 },
 "processRefundDays": {
-"description": "The field specifies the number of days it takes for merchants to process refunds, field is optional.",
+"description": "Optional. The field specifies the number of days it takes for merchants to process refunds.",
 "format": "int32",
 "type": "integer"
 },
@@ -2667,7 +3104,7 @@ false
 "description": "Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set."
 },
 "returnLabelSource": {
-"description": "The field specifies the return label source. This field is required when return method is BY_MAIL.",
+"description": "Optional. The field specifies the return label source.",
 "enum": [
 "RETURN_LABEL_SOURCE_UNSPECIFIED",
 "DOWNLOAD_AND_PRINT",
@@ -3028,8 +3465,14 @@ false
 },
 "type": "object"
 },
+"ProductsManagement": {
+"description": "`ProductsManagement` payload.",
+"id": "ProductsManagement",
+"properties": {},
+"type": "object"
+},
 "Program": {
-"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/topic/9240261?ref_topic=7257954,7259405,&sjid=796648681813264022-EU) program, which enables products from a merchant's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`",
+"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a merchant's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`",
 "id": "Program",
 "properties": {
 "activeRegionCodes": {
@@ -3077,6 +3520,21 @@ false
 },
 "type": "object"
 },
+"ProposeAccountServiceRequest": {
+"description": "Request to propose an account service.",
+"id": "ProposeAccountServiceRequest",
+"properties": {
+"accountService": {
+"$ref": "AccountService",
+"description": "Required. The account service to propose."
+},
+"provider": {
+"description": "Required. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).",
+"type": "string"
+}
+},
+"type": "object"
+},
 "RateGroup": {
 "description": "Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means \"everything else\". The other `applicable_shipping_labels` must not overlap.",
 "id": "RateGroup",
@@ -3150,6 +3608,12 @@ false
 },
 "type": "object"
 },
+"RejectAccountServiceRequest": {
+"description": "Request to reject an account service.",
+"id": "RejectAccountServiceRequest",
+"properties": {},
+"type": "object"
+},
 "Required": {
 "description": "Describes the terms of service which are required to be accepted.",
 "id": "Required",
@@ -3504,7 +3968,7 @@ false
 "type": "object"
 },
 "TermsOfServiceAgreementState": {
-"description": "This resource represents the agreement state for a given account and terms of service kind. The state is as follows: * If the merchant has accepted a terms of service, `accepted` will be populated, otherwise it will be empty * If the merchant 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 `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services we expect 3Ps 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 `tos_file_uri`. The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource.",
+"description": "This resource represents the agreement state for a given account and terms of service kind. The state is as follows: * If the merchant has accepted a terms of service, `accepted` will be populated, otherwise it will be empty * If the merchant 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 `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services we expect 3Ps 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 `tos_file_uri`). The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource.",
 "id": "TermsOfServiceAgreementState",
 "properties": {
 "accepted": {
@@ -3731,7 +4195,7 @@ false
 "type": "string"
 },
 "warehouse": {
-"description": "Required. Warehouse name. This should match warehouse",
+"description": "Required. Warehouse name. This should match [warehouse](/merchant/api/reference/rest/accounts_v1beta/accounts.shippingSettings#warehouse)",
 "type": "string"
 }
 },