google-api-python-client 2.153.0__py2.py3-none-any.whl → 2.155.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/integrations.v1.json

@@ -212,6 +212,34 @@
 "resources": {
 "locations": {
 "methods": {
+"generateOpenApiSpec": {
+"description": "Generate OpenAPI spec for the requested integrations and api triggers",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}:generateOpenApiSpec",
+"httpMethod": "POST",
+"id": "integrations.projects.locations.generateOpenApiSpec",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Project and location from which the integrations should be fetched. Format: projects/{project}/location/{location}",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:generateOpenApiSpec",
+"request": {
+"$ref": "GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecRequest"
+},
+"response": {
+"$ref": "GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "getClients": {
 "description": "Gets the client configuration for the given project and location resource name",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clients",
@@ -4497,7 +4525,7 @@
 }
 }
 },
-"revision": "20241028",
+"revision": "20241207",
 "rootUrl": "https://integrations.googleapis.com/",
 "schemas": {
 "CrmlogErrorCode": {
@@ -9444,6 +9472,7 @@ false
 "PREVIEW",
 "GA",
 "DEPRECATED",
+"TEST",
 "PRIVATE_PREVIEW"
 ],
 "enumDescriptions": [
@@ -9451,6 +9480,7 @@ false
 "PREVIEW.",
 "GA.",
 "DEPRECATED.",
+"TEST.",
 "PRIVATE_PREVIEW."
 ],
 "readOnly": true,
@@ -9641,7 +9671,7 @@ false
 "type": "string"
 },
 "deploymentModel": {
-"description": "Optional. Indicates whether connector is deployed on GKE/CloudRun",
+"description": "Output only. Indicates whether connector is deployed on GKE/CloudRun",
 "enum": [
 "DEPLOYMENT_MODEL_UNSPECIFIED",
 "GKE_MST",
@@ -9652,6 +9682,7 @@ false
 "Default model gke mst.",
 "Cloud run mst."
 ],
+"readOnly": true,
 "type": "string"
 },
 "deploymentModelMigrationState": {
@@ -9797,7 +9828,7 @@ false
 "id": "GoogleCloudConnectorsV1EventingConfig",
 "properties": {
 "additionalVariables": {
-"description": "Additional eventing related field values",
+"description": "Optional. Additional eventing related field values",
 "items": {
 "$ref": "GoogleCloudConnectorsV1ConfigVariable"
 },
@@ -9805,14 +9836,14 @@ false
 },
 "authConfig": {
 "$ref": "GoogleCloudConnectorsV1AuthConfig",
-"description": "Auth details for the webhook adapter."
+"description": "Optional. Auth details for the webhook adapter."
 },
 "deadLetterConfig": {
 "$ref": "GoogleCloudConnectorsV1EventingConfigDeadLetterConfig",
 "description": "Optional. Dead letter configuration for eventing of a connection."
 },
 "enrichmentEnabled": {
-"description": "Enrichment Enabled.",
+"description": "Optional. Enrichment Enabled.",
 "type": "boolean"
 },
 "eventsListenerIngressEndpoint": {
@@ -9833,7 +9864,7 @@ false
 },
 "registrationDestinationConfig": {
 "$ref": "GoogleCloudConnectorsV1DestinationConfig",
-"description": "Registration endpoint for auto registration."
+"description": "Optional. Registration endpoint for auto registration."
 }
 },
 "type": "object"
@@ -10100,14 +10131,14 @@ false
 "id": "GoogleCloudConnectorsV1SslConfig",
 "properties": {
 "additionalVariables": {
-"description": "Additional SSL related field values",
+"description": "Optional. Additional SSL related field values",
 "items": {
 "$ref": "GoogleCloudConnectorsV1ConfigVariable"
 },
 "type": "array"
 },
 "clientCertType": {
-"description": "Type of Client Cert (PEM/JKS/.. etc.)",
+"description": "Optional. Type of Client Cert (PEM/JKS/.. etc.)",
 "enum": [
 "CERT_TYPE_UNSPECIFIED",
 "PEM"
@@ -10120,22 +10151,22 @@ false
 },
 "clientCertificate": {
 "$ref": "GoogleCloudConnectorsV1Secret",
-"description": "Client Certificate"
+"description": "Optional. Client Certificate"
 },
 "clientPrivateKey": {
 "$ref": "GoogleCloudConnectorsV1Secret",
-"description": "Client Private Key"
+"description": "Optional. Client Private Key"
 },
 "clientPrivateKeyPass": {
 "$ref": "GoogleCloudConnectorsV1Secret",
-"description": "Secret containing the passphrase protecting the Client Private Key"
+"description": "Optional. Secret containing the passphrase protecting the Client Private Key"
 },
 "privateServerCertificate": {
 "$ref": "GoogleCloudConnectorsV1Secret",
-"description": "Private Server Certificate. Needs to be specified if trust model is `PRIVATE`."
+"description": "Optional. Private Server Certificate. Needs to be specified if trust model is `PRIVATE`."
 },
 "serverCertType": {
-"description": "Type of Server Cert (PEM/JKS/.. etc.)",
+"description": "Optional. Type of Server Cert (PEM/JKS/.. etc.)",
 "enum": [
 "CERT_TYPE_UNSPECIFIED",
 "PEM"
@@ -10147,7 +10178,7 @@ false
 "type": "string"
 },
 "trustModel": {
-"description": "Trust Model of the SSL connection",
+"description": "Optional. Trust Model of the SSL connection",
 "enum": [
 "PUBLIC",
 "PRIVATE",
@@ -10161,7 +10192,7 @@ false
 "type": "string"
 },
 "type": {
-"description": "Controls the ssl type for the given connector version.",
+"description": "Optional. Controls the ssl type for the given connector version.",
 "enum": [
 "SSL_TYPE_UNSPECIFIED",
 "TLS",
@@ -10175,7 +10206,7 @@ false
 "type": "string"
 },
 "useSsl": {
-"description": "Bool for enabling SSL",
+"description": "Optional. Bool for enabling SSL",
 "type": "boolean"
 }
 },
@@ -10210,12 +10241,30 @@ false
 },
 "type": "object"
 },
+"GoogleCloudIntegrationsV1alphaApiTriggerResource": {
+"description": "List of API triggerID and their workflow resource name.",
+"id": "GoogleCloudIntegrationsV1alphaApiTriggerResource",
+"properties": {
+"integrationResource": {
+"description": "Required. Integration where the API is published",
+"type": "string"
+},
+"triggerId": {
+"description": "Required. Trigger Id of the API trigger(s) in the integration",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudIntegrationsV1alphaAssertion": {
-"description": "An assertion which will check for a condition over task execution status or an expression for task output variables Next available id: 5",
+"description": "An assertion which will check for a condition over task execution status or an expression for task output variables",
 "id": "GoogleCloudIntegrationsV1alphaAssertion",
 "properties": {
 "assertionStrategy": {
-"description": "The type of assertion to perform.",
+"description": "Optional. The type of assertion to perform.",
 "enum": [
 "ASSERTION_STRATEGY_UNSPECIFIED",
 "ASSERT_SUCCESSFUL_EXECUTION",
@@ -11566,6 +11615,45 @@ false
 },
 "type": "object"
 },
+"GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecRequest": {
+"description": "Request for GenerateOpenApiSpec.",
+"id": "GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecRequest",
+"properties": {
+"apiTriggerResources": {
+"description": "Required. List of api triggers",
+"items": {
+"$ref": "GoogleCloudIntegrationsV1alphaApiTriggerResource"
+},
+"type": "array"
+},
+"fileFormat": {
+"description": "Required. File format for generated spec.",
+"enum": [
+"FILE_FORMAT_UNSPECIFIED",
+"JSON",
+"YAML"
+],
+"enumDescriptions": [
+"Unspecified file format",
+"JSON File Format",
+"YAML File Format"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecResponse": {
+"description": "Response of the GenerateOpenApiSpec API.",
+"id": "GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecResponse",
+"properties": {
+"openApiSpec": {
+"description": "Open API spec as per the required format",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudIntegrationsV1alphaGenerateTokenResponse": {
 "description": "Returns success or error message",
 "id": "GoogleCloudIntegrationsV1alphaGenerateTokenResponse",
@@ -13053,7 +13141,7 @@ false
 "type": "object"
 },
 "GoogleCloudIntegrationsV1alphaScheduleIntegrationsRequest": {
-"description": "The request for scheduling an integration. Next available id: 11",
+"description": "The request for scheduling an integration.",
 "id": "GoogleCloudIntegrationsV1alphaScheduleIntegrationsRequest",
 "properties": {
 "inputParameters": {

googleapiclient/discovery_cache/documents/language.v1beta2.json

@@ -246,7 +246,7 @@
 }
 }
 },
-"revision": "20241103",
+"revision": "20241110",
 "rootUrl": "https://language.googleapis.com/",
 "schemas": {
 "AnalyzeEntitiesRequest": {
@@ -1361,7 +1361,7 @@
 },
 "sentiment": {
 "$ref": "Sentiment",
-"description": "For calls to AnalyzeEntitySentimentRequest or if AnnotateTextRequest.Features.extract_entity_sentiment is set to true, this field will contain the aggregate sentiment expressed for this entity in the provided document."
+"description": "For calls to AnalyzeEntitySentiment or if AnnotateTextRequest.Features.extract_entity_sentiment is set to true, this field will contain the aggregate sentiment expressed for this entity in the provided document."
 },
 "type": {
 "description": "The entity type.",
@@ -1406,7 +1406,7 @@
 "properties": {
 "sentiment": {
 "$ref": "Sentiment",
-"description": "For calls to AnalyzeEntitySentimentRequest or if AnnotateTextRequest.Features.extract_entity_sentiment is set to true, this field will contain the sentiment expressed for this mention of the entity in the provided document."
+"description": "For calls to AnalyzeEntitySentiment or if AnnotateTextRequest.Features.extract_entity_sentiment is set to true, this field will contain the sentiment expressed for this mention of the entity in the provided document."
 },
 "text": {
 "$ref": "TextSpan",
@@ -2540,7 +2540,7 @@
 "properties": {
 "sentiment": {
 "$ref": "Sentiment",
-"description": "For calls to AnalyzeSentimentRequest or if AnnotateTextRequest.Features.extract_document_sentiment is set to true, this field will contain the sentiment for the sentence."
+"description": "For calls to AnalyzeSentiment or if AnnotateTextRequest.Features.extract_document_sentiment is set to true, this field will contain the sentiment for the sentence."
 },
 "text": {
 "$ref": "TextSpan",

googleapiclient/discovery_cache/documents/language.v2.json

@@ -208,7 +208,7 @@
 }
 }
 },
-"revision": "20241103",
+"revision": "20241110",
 "rootUrl": "https://language.googleapis.com/",
 "schemas": {
 "AnalyzeEntitiesRequest": {
@@ -250,7 +250,7 @@
 "type": "array"
 },
 "languageCode": {
-"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language field for more details.",
+"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language_code field for more details.",
 "type": "string"
 },
 "languageSupported": {
@@ -296,7 +296,7 @@
 "description": "The overall sentiment of the input document."
 },
 "languageCode": {
-"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language field for more details.",
+"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language_code field for more details.",
 "type": "string"
 },
 "languageSupported": {
@@ -383,14 +383,14 @@
 "description": "The overall sentiment for the document. Populated if the user enables AnnotateTextRequest.Features.extract_document_sentiment."
 },
 "entities": {
-"description": "Entities, along with their semantic information, in the input document. Populated if the user enables AnnotateTextRequest.Features.extract_entities or AnnotateTextRequest.Features.extract_entity_sentiment.",
+"description": "Entities, along with their semantic information, in the input document. Populated if the user enables AnnotateTextRequest.Features.extract_entities .",
 "items": {
 "$ref": "Entity"
 },
 "type": "array"
 },
 "languageCode": {
-"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language field for more details.",
+"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language_code field for more details.",
 "type": "string"
 },
 "languageSupported": {
@@ -458,7 +458,7 @@
 "type": "array"
 },
 "languageCode": {
-"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language field for more details.",
+"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language_code field for more details.",
 "type": "string"
 },
 "languageSupported": {
@@ -977,7 +977,7 @@
 },
 "sentiment": {
 "$ref": "Sentiment",
-"description": "For calls to AnalyzeEntitySentimentRequest or if AnnotateTextRequest.Features.extract_entity_sentiment is set to true, this field will contain the aggregate sentiment expressed for this entity in the provided document."
+"description": "For calls to AnalyzeEntitySentiment this field will contain the aggregate sentiment expressed for this entity in the provided document."
 },
 "type": {
 "description": "The entity type.",
@@ -1027,7 +1027,7 @@
 },
 "sentiment": {
 "$ref": "Sentiment",
-"description": "For calls to AnalyzeEntitySentimentRequest or if AnnotateTextRequest.Features.extract_entity_sentiment is set to true, this field will contain the sentiment expressed for this mention of the entity in the provided document."
+"description": "For calls to AnalyzeEntitySentiment this field will contain the sentiment expressed for this mention of the entity in the provided document."
 },
 "text": {
 "$ref": "TextSpan",
@@ -1500,7 +1500,7 @@
 "id": "ModerateTextResponse",
 "properties": {
 "languageCode": {
-"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language field for more details.",
+"description": "The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language_code field for more details.",
 "type": "string"
 },
 "languageSupported": {
@@ -1916,7 +1916,7 @@
 "properties": {
 "sentiment": {
 "$ref": "Sentiment",
-"description": "For calls to AnalyzeSentimentRequest or if AnnotateTextRequest.Features.extract_document_sentiment is set to true, this field will contain the sentiment for the sentence."
+"description": "For calls to AnalyzeSentiment or if AnnotateTextRequest.Features.extract_document_sentiment is set to true, this field will contain the sentiment for the sentence."
 },
 "text": {
 "$ref": "TextSpan",

googleapiclient/discovery_cache/documents/localservices.v1.json

@@ -250,7 +250,7 @@
 }
 }
 },
-"revision": "20240707",
+"revision": "20241202",
 "rootUrl": "https://localservices.googleapis.com/",
 "schemas": {
 "GoogleAdsHomeservicesLocalservicesV1AccountReport": {
@@ -568,11 +568,11 @@
 "id": "GoogleTypeTimeZone",
 "properties": {
 "id": {
-"description": "IANA Time Zone Database time zone, e.g. \"America/New_York\".",
+"description": "IANA Time Zone Database time zone. For example \"America/New_York\".",
 "type": "string"
 },
 "version": {
-"description": "Optional. IANA Time Zone Database version number, e.g. \"2019a\".",
+"description": "Optional. IANA Time Zone Database version number. For example \"2019a\".",
 "type": "string"
 }
 },

googleapiclient/discovery_cache/documents/looker.v1.json

@@ -731,7 +731,7 @@
 }
 }
 },
-"revision": "20241016",
+"revision": "20241106",
 "rootUrl": "https://looker.googleapis.com/",
 "schemas": {
 "AdminSettings": {
@@ -1222,7 +1222,7 @@
 },
 "userMetadata": {
 "$ref": "UserMetadata",
-"description": "User metadata."
+"description": "Optional. User metadata."
 }
 },
 "type": "object"

googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json

@@ -233,7 +233,7 @@
 "type": "string"
 },
 "provider": {
-"description": "Required. The parent account. Format: `accounts/{account}`",
+"description": "Required. The aggregation service provider. Format: `providers/{providerId}`",
 "location": "path",
 "pattern": "^accounts/[^/]+$",
 "required": true,
@@ -708,7 +708,7 @@
 "onlineReturnPolicies": {
 "methods": {
 "get": {
-"description": "Gets an existing return policy.",
+"description": "Gets an existing return policy for a given merchant.",
 "flatPath": "accounts/v1beta/accounts/{accountsId}/onlineReturnPolicies/{onlineReturnPoliciesId}",
 "httpMethod": "GET",
 "id": "merchantapi.accounts.onlineReturnPolicies.get",
@@ -733,7 +733,7 @@
 ]
 },
 "list": {
-"description": "Lists all existing return policies.",
+"description": "Lists all existing return policies for a given merchant.",
 "flatPath": "accounts/v1beta/accounts/{accountsId}/onlineReturnPolicies",
 "httpMethod": "GET",
 "id": "merchantapi.accounts.onlineReturnPolicies.list",
@@ -1417,7 +1417,7 @@
 }
 }
 },
-"revision": "20241104",
+"revision": "20241124",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "Accepted": {
@@ -1671,7 +1671,7 @@
 "type": "object"
 },
 "BusinessInfo": {
-"description": "Collection of information related to a business.",
+"description": "The `BusinessInfo` message contains essential information about a merchant's business. This message captures key business details such as physical address, customer service contacts, and region-specific identifiers.",
 "id": "BusinessInfo",
 "properties": {
 "address": {
@@ -1714,7 +1714,7 @@
 "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?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.",
+"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",
 "properties": {
 "carrier": {
@@ -2060,7 +2060,7 @@
 "type": "object"
 },
 "Homepage": {
-"description": "A store's homepage.",
+"description": "The `Homepage` message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).",
 "id": "Homepage",
 "properties": {
 "claimed": {
@@ -2418,7 +2418,7 @@ false
 "type": "boolean"
 },
 "countries": {
-"description": "The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.",
+"description": "Required. Immutable. The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.",
 "items": {
 "type": "string"
 },
@@ -2442,7 +2442,7 @@ false
 "type": "array"
 },
 "label": {
-"description": "This field represents the unique user-defined label of the return policy. It is important to note that the same label cannot be used in different return policies for the same country. Unless a product specifies a specific label attribute, policies will be automatically labeled as 'default'. To assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.",
+"description": "Required. Immutable. This field represents the unique user-defined label of the return policy. It is important to note that the same label cannot be used in different return policies for the same country. Unless a product specifies a specific label attribute, policies will be automatically labeled as 'default'. To assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.",
 "type": "string"
 },
 "name": {
@@ -2487,7 +2487,7 @@ false
 "type": "string"
 },
 "returnPolicyUri": {
-"description": "The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.",
+"description": "Required. The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.",
 "type": "string"
 },
 "returnShippingFee": {
@@ -2502,7 +2502,7 @@ false
 "id": "PhoneNumber",
 "properties": {
 "e164Number": {
-"description": "The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting, e.g.: - correct: \"+15552220123\" - incorrect: \"+1 (555) 222-01234 x123\". The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes",
+"description": "The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: \"+15552220123\" - incorrect: \"+1 (555) 222-01234 x123\". The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes",
 "type": "string"
 },
 "extension": {
@@ -2545,18 +2545,18 @@ false
 "type": "object"
 },
 "PostalAddress": {
-"description": "Represents a postal address, e.g. for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created via user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, please see: https://support.google.com/business/answer/6397478",
+"description": "Represents a postal address. For example for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478",
 "id": "PostalAddress",
 "properties": {
 "addressLines": {
-"description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (e.g. \"Austin, TX\"), it is important that the line order is clear. The order of address lines should be \"envelope order\" for the country/region of the address. In places where this can vary (e.g. Japan), address_language is used to make it explicit (e.g. \"ja\" for large-to-small ordering and \"ja-Latn\" or \"en\" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).",
+"description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (For example \"Austin, TX\"), it is important that the line order is clear. The order of address lines should be \"envelope order\" for the country/region of the address. In places where this can vary (For example Japan), address_language is used to make it explicit (For example \"ja\" for large-to-small ordering and \"ja-Latn\" or \"en\" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "administrativeArea": {
-"description": "Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (e.g. \"Barcelona\" and not \"Catalonia\"). Many countries don't use an administrative area in postal addresses. E.g. in Switzerland this should be left unpopulated.",
+"description": "Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (For example \"Barcelona\" and not \"Catalonia\"). Many countries don't use an administrative area in postal addresses. For example in Switzerland this should be left unpopulated.",
 "type": "string"
 },
 "languageCode": {
@@ -2572,7 +2572,7 @@ false
 "type": "string"
 },
 "postalCode": {
-"description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (e.g. state/zip validation in the U.S.A.).",
+"description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).",
 "type": "string"
 },
 "recipients": {
@@ -2592,7 +2592,7 @@ false
 "type": "integer"
 },
 "sortingCode": {
-"description": "Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like \"CEDEX\", optionally followed by a number (e.g. \"CEDEX 7\"), or just a number alone, representing the \"sector code\" (Jamaica), \"delivery area indicator\" (Malawi) or \"post office indicator\" (e.g. C\u00f4te d'Ivoire).",
+"description": "Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like \"CEDEX\", optionally followed by a number (For example \"CEDEX 7\"), or just a number alone, representing the \"sector code\" (Jamaica), \"delivery area indicator\" (Malawi) or \"post office indicator\" (For example C\u00f4te d'Ivoire).",
 "type": "string"
 },
 "sublocality": {
@@ -2762,7 +2762,7 @@ false
 "type": "array"
 },
 "expirationTime": {
-"description": "The product expiration time.",
+"description": "The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
 "format": "google-datetime",
 "type": "string"
 },
@@ -2980,7 +2980,7 @@ false
 "description": "Fixed return shipping fee amount. This value is only applicable when type is `FIXED`. We will treat the return shipping fee as free if type is `FIXED` and this value is not set."
 },
 "type": {
-"description": "Type of return shipping fee.",
+"description": "Required. Type of return shipping fee.",
 "enum": [
 "TYPE_UNSPECIFIED",
 "FIXED",
@@ -3112,11 +3112,11 @@ false
 "type": "object"
 },
 "ShortCode": {
-"description": "An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (e.g. \"Text 611 to see how many minutes you have remaining on your plan.\"). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (e.g. US and CA).",
+"description": "An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example \"Text 611 to see how many minutes you have remaining on your plan.\"). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA).",
 "id": "ShortCode",
 "properties": {
 "number": {
-"description": "Required. The short code digits, without a leading plus ('+') or country calling code, e.g. \"611\".",
+"description": "Required. The short code digits, without a leading plus ('+') or country calling code. For example \"611\".",
 "type": "string"
 },
 "regionCode": {
@@ -3281,11 +3281,11 @@ false
 "id": "TimeZone",
 "properties": {
 "id": {
-"description": "IANA Time Zone Database time zone, e.g. \"America/New_York\".",
+"description": "IANA Time Zone Database time zone. For example \"America/New_York\".",
 "type": "string"
 },
 "version": {
-"description": "Optional. IANA Time Zone Database version number, e.g. \"2019a\".",
+"description": "Optional. IANA Time Zone Database version number. For example \"2019a\".",
 "type": "string"
 }
 },
@@ -3429,7 +3429,7 @@ false
 "type": "object"
 },
 "Warehouse": {
-"description": "A fulfillment warehouse, which stores and handles inventory. Next tag: 7",
+"description": "A fulfillment warehouse, which stores and handles inventory.",
 "id": "Warehouse",
 "properties": {
 "businessDayConfig": {

googleapiclient/discovery_cache/documents/merchantapi.conversions_v1beta.json

@@ -295,7 +295,7 @@
 }
 }
 },
-"revision": "20241101",
+"revision": "20241119",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "AttributionSettings": {
@@ -597,7 +597,7 @@ false
 "type": "array"
 },
 "expirationTime": {
-"description": "The product expiration time.",
+"description": "The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
 "format": "google-datetime",
 "type": "string"
 },