google-api-python-client 2.91.0__py2.py3-none-any.whl → 2.93.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json

@@ -3253,7 +3253,7 @@
                           ]
                         },
                         "list": {
-                          "description": "Fetches a list of results for a given test case.",
+                          "description": "Fetches the list of run results for the given test case. A maximum of 100 results are kept for each test case.",
                           "flatPath": "v3beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/testCases/{testCasesId}/results",
                           "httpMethod": "GET",
                           "id": "dialogflow.projects.locations.agents.testCases.results.list",
@@ -3820,7 +3820,7 @@
       }
     }
   },
-  "revision": "20230621",
+  "revision": "20230707",
   "rootUrl": "https://dialogflow.googleapis.com/",
   "schemas": {
     "GoogleCloudDialogflowCxV3AudioInput": {
@@ -4215,13 +4215,17 @@
       "id": "GoogleCloudDialogflowCxV3ExportAgentResponse",
       "properties": {
         "agentContent": {
-          "description": "Uncompressed raw byte content for agent.",
+          "description": "Uncompressed raw byte content for agent. This field is populated if none of `agent_uri` and `git_destination` are specified in ExportAgentRequest.",
           "format": "byte",
           "type": "string"
         },
         "agentUri": {
           "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.",
           "type": "string"
+        },
+        "commitSha": {
+          "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.",
+          "type": "string"
         }
       },
       "type": "object"
@@ -5492,6 +5496,7 @@
           "type": "object"
         },
         "password": {
+          "deprecated": true,
           "description": "The password for HTTP Basic authentication.",
           "type": "string"
         },
@@ -5511,6 +5516,7 @@
           "type": "string"
         },
         "username": {
+          "deprecated": true,
           "description": "The user name for HTTP Basic authentication.",
           "type": "string"
         },
@@ -5808,9 +5814,14 @@
           "type": "boolean"
         },
         "enableStackdriverLogging": {
+          "deprecated": true,
           "description": "Indicates if stackdriver logging is enabled for the agent. Please use agent.advanced_settings instead.",
           "type": "boolean"
         },
+        "gitIntegrationSettings": {
+          "$ref": "GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettings",
+          "description": "Git integration settings for this agent."
+        },
         "locked": {
           "description": "Indicates whether the agent is locked for changes. If the agent is locked, modifications to the agent will be rejected except for RestoreAgent.",
           "type": "boolean"
@@ -5849,6 +5860,47 @@
       },
       "type": "object"
     },
+    "GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettings": {
+      "description": "Settings for connecting to Git repository for an agent.",
+      "id": "GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettings",
+      "properties": {
+        "githubSettings": {
+          "$ref": "GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGithubSettings",
+          "description": "GitHub settings."
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGithubSettings": {
+      "description": "Settings of integration with GitHub.",
+      "id": "GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGithubSettings",
+      "properties": {
+        "accessToken": {
+          "description": "The access token used to authenticate the access to the GitHub repository.",
+          "type": "string"
+        },
+        "branches": {
+          "description": "A list of branches configured to be used from Dialogflow.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "displayName": {
+          "description": "The unique repository display name for the GitHub repository.",
+          "type": "string"
+        },
+        "repositoryUri": {
+          "description": "The GitHub repository URI related to the agent.",
+          "type": "string"
+        },
+        "trackingBranch": {
+          "description": "The branch of GitHub repository tracked for this agent.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudDialogflowCxV3beta1AgentValidationResult": {
       "description": "The response message for Agents.GetAgentValidationResult.",
       "id": "GoogleCloudDialogflowCxV3beta1AgentValidationResult",
@@ -6865,6 +6917,10 @@
           "description": "Optional. Environment name. If not set, draft environment is assumed. Format: `projects//locations//agents//environments/`.",
           "type": "string"
         },
+        "gitDestination": {
+          "$ref": "GoogleCloudDialogflowCxV3beta1ExportAgentRequestGitDestination",
+          "description": "Optional. The Git branch to export the agent to."
+        },
         "includeBigqueryExportSettings": {
           "description": "Optional. Whether to include BigQuery Export setting.",
           "type": "boolean"
@@ -6872,18 +6928,37 @@
       },
       "type": "object"
     },
+    "GoogleCloudDialogflowCxV3beta1ExportAgentRequestGitDestination": {
+      "description": "Settings for exporting to a git branch.",
+      "id": "GoogleCloudDialogflowCxV3beta1ExportAgentRequestGitDestination",
+      "properties": {
+        "commitMessage": {
+          "description": "Commit message for the git push.",
+          "type": "string"
+        },
+        "trackingBranch": {
+          "description": "Tracking branch for the git push.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudDialogflowCxV3beta1ExportAgentResponse": {
       "description": "The response message for Agents.ExportAgent.",
       "id": "GoogleCloudDialogflowCxV3beta1ExportAgentResponse",
       "properties": {
         "agentContent": {
-          "description": "Uncompressed raw byte content for agent.",
+          "description": "Uncompressed raw byte content for agent. This field is populated if none of `agent_uri` and `git_destination` are specified in ExportAgentRequest.",
           "format": "byte",
           "type": "string"
         },
         "agentUri": {
           "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.",
           "type": "string"
+        },
+        "commitSha": {
+          "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.",
+          "type": "string"
         }
       },
       "type": "object"
@@ -8380,9 +8455,11 @@
         },
         "intent": {
           "$ref": "GoogleCloudDialogflowCxV3beta1Intent",
+          "deprecated": true,
           "description": "The Intent that matched the conversational query. Some, not all fields are filled in this message, including but not limited to: `name` and `display_name`. This field is deprecated, please use QueryResult.match instead."
         },
         "intentDetectionConfidence": {
+          "deprecated": true,
           "description": "The intent detection confidence. Values range from 0.0 (completely uncertain) to 1.0 (completely certain). This value is for informational purpose only and is only used to help match the best intent within the classification threshold. This value may change for the same end-user expression at any time due to a model retraining or change in implementation. This field is deprecated, please use QueryResult.match instead.",
           "format": "float",
           "type": "number"
@@ -8680,6 +8757,10 @@
           "description": "The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to restore agent from. The format of this URI must be `gs:///`. Dialogflow performs a read operation for the Cloud Storage object on the caller's behalf, so your request authentication must have read permissions for the object. For more information, see [Dialogflow access control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).",
           "type": "string"
         },
+        "gitSource": {
+          "$ref": "GoogleCloudDialogflowCxV3beta1RestoreAgentRequestGitSource",
+          "description": "Setting for restoring from a git branch"
+        },
         "restoreOption": {
           "description": "Agent restore mode. If not specified, `KEEP` is assumed.",
           "enum": [
@@ -8697,6 +8778,17 @@
       },
       "type": "object"
     },
+    "GoogleCloudDialogflowCxV3beta1RestoreAgentRequestGitSource": {
+      "description": "Settings for restoring from a git branch",
+      "id": "GoogleCloudDialogflowCxV3beta1RestoreAgentRequestGitSource",
+      "properties": {
+        "trackingBranch": {
+          "description": "tracking branch for the git pull",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudDialogflowCxV3beta1RolloutConfig": {
       "description": "The configuration for auto rollout.",
       "id": "GoogleCloudDialogflowCxV3beta1RolloutConfig",
@@ -9598,6 +9690,7 @@
           "type": "string"
         },
         "resources": {
+          "deprecated": true,
           "description": "The names of the resources where the message is found.",
           "items": {
             "type": "string"
@@ -9823,6 +9916,7 @@
           "type": "object"
         },
         "password": {
+          "deprecated": true,
           "description": "The password for HTTP Basic authentication.",
           "type": "string"
         },
@@ -9842,6 +9936,7 @@
           "type": "string"
         },
         "username": {
+          "deprecated": true,
           "description": "The user name for HTTP Basic authentication.",
           "type": "string"
         },
@@ -11622,6 +11717,11 @@
             "EXAMPLE",
             "TEMPLATE"
           ],
+          "enumDeprecated": [
+            false,
+            false,
+            true
+          ],
           "enumDescriptions": [
             "Not specified. This value should never be used.",
             "Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.",
@@ -12719,6 +12819,7 @@
           "type": "boolean"
         },
         "mlEnabled": {
+          "deprecated": true,
           "description": "Optional. Indicates whether Machine Learning is enabled for the intent. Note: If `ml_enabled` setting is set to false, then this intent is not taken into account during inference in `ML ONLY` match mode. Also, auto-markup in the UI is turned off. DEPRECATED! Please use `ml_disabled` field instead. NOTE: If both `ml_enabled` and `ml_disabled` are either not set or false, then the default value is determined as follows: - Before April 15th, 2018 the default is: ml_enabled = false / ml_disabled = true. - After April 15th, 2018 the default is: ml_enabled = true / ml_disabled = false.",
           "type": "boolean"
         },
@@ -13820,6 +13921,11 @@
             "EXAMPLE",
             "TEMPLATE"
           ],
+          "enumDeprecated": [
+            false,
+            false,
+            true
+          ],
           "enumDescriptions": [
             "Not specified. This value should never be used.",
             "Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.",

googleapiclient/discovery_cache/documents/digitalassetlinks.v1.json

@@ -199,7 +199,7 @@
       }
     }
   },
-  "revision": "20230620",
+  "revision": "20230704",
   "rootUrl": "https://digitalassetlinks.googleapis.com/",
   "schemas": {
     "AndroidAppAsset": {

googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json

@@ -249,7 +249,7 @@
                                   "type": "string"
                                 },
                                 "parent": {
-                                  "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`. Use `default_branch` as the branch ID, to list documents under the default branch. If the caller does not have permission to list Documentss under this branch, regardless of whether or not this branch exists, a `PERMISSION_DENIED` error is returned.",
+                                  "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`. Use `default_branch` as the branch ID, to list documents under the default branch. If the caller does not have permission to list Documents under this branch, regardless of whether or not this branch exists, a `PERMISSION_DENIED` error is returned.",
                                   "location": "path",
                                   "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$",
                                   "required": true,
@@ -652,7 +652,7 @@
                     "userEvents": {
                       "methods": {
                         "collect": {
-                          "description": "Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Discovery Engine API JavaScript pixel and Google Tag Manager. Users should not call this method directly.",
+                          "description": "Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a third-party domain. This method is used only by the Discovery Engine API JavaScript pixel and Google Tag Manager. Users should not call this method directly.",
                           "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/userEvents:collect",
                           "httpMethod": "GET",
                           "id": "discoveryengine.projects.locations.collections.dataStores.userEvents.collect",
@@ -674,7 +674,7 @@
                               "type": "string"
                             },
                             "uri": {
-                              "description": "The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.",
+                              "description": "The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for third-party requests.",
                               "location": "query",
                               "type": "string"
                             },
@@ -1064,7 +1064,7 @@
                               "type": "string"
                             },
                             "parent": {
-                              "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`. Use `default_branch` as the branch ID, to list documents under the default branch. If the caller does not have permission to list Documentss under this branch, regardless of whether or not this branch exists, a `PERMISSION_DENIED` error is returned.",
+                              "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`. Use `default_branch` as the branch ID, to list documents under the default branch. If the caller does not have permission to list Documents under this branch, regardless of whether or not this branch exists, a `PERMISSION_DENIED` error is returned.",
                               "location": "path",
                               "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$",
                               "required": true,
@@ -1393,7 +1393,7 @@
                 "userEvents": {
                   "methods": {
                     "collect": {
-                      "description": "Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Discovery Engine API JavaScript pixel and Google Tag Manager. Users should not call this method directly.",
+                      "description": "Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a third-party domain. This method is used only by the Discovery Engine API JavaScript pixel and Google Tag Manager. Users should not call this method directly.",
                       "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/userEvents:collect",
                       "httpMethod": "GET",
                       "id": "discoveryengine.projects.locations.dataStores.userEvents.collect",
@@ -1415,7 +1415,7 @@
                           "type": "string"
                         },
                         "uri": {
-                          "description": "The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.",
+                          "description": "The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for third-party requests.",
                           "location": "query",
                           "type": "string"
                         },
@@ -1666,7 +1666,7 @@
       }
     }
   },
-  "revision": "20230620",
+  "revision": "20230629",
   "rootUrl": "https://discoveryengine.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -1816,7 +1816,7 @@
       "type": "object"
     },
     "GoogleCloudDiscoveryengineV1ImportDocumentsMetadata": {
-      "description": "Metadata related to the progress of the ImportDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.",
+      "description": "Metadata related to the progress of the ImportDocuments operation. This is returned by the google.longrunning.Operation.metadata field.",
       "id": "GoogleCloudDiscoveryengineV1ImportDocumentsMetadata",
       "properties": {
         "createTime": {
@@ -1865,14 +1865,14 @@
       "id": "GoogleCloudDiscoveryengineV1ImportErrorConfig",
       "properties": {
         "gcsPrefix": {
-          "description": "Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+          "description": "Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
           "type": "string"
         }
       },
       "type": "object"
     },
     "GoogleCloudDiscoveryengineV1ImportUserEventsMetadata": {
-      "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+      "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
       "id": "GoogleCloudDiscoveryengineV1ImportUserEventsMetadata",
       "properties": {
         "createTime": {
@@ -2014,7 +2014,7 @@
       "id": "GoogleCloudDiscoveryengineV1alphaBigQuerySource",
       "properties": {
         "dataSchema": {
-          "description": "The schema to use when parsing the data from the source. Supported values for user event imports: * `user_event` (default): One UserEvent per row. Supported values for document imports: * `document` (default): One Document format per row. Each document must have a valid Document.id and one of Document.json_data or Document.struct_data. * `custom`: One custom data per row in arbitrary format that conforms the defined Schema of the data store. This can only be used by the GENERIC Data Store vertical.",
+          "description": "The schema to use when parsing the data from the source. Supported values for user event imports: * `user_event` (default): One UserEvent per row. Supported values for document imports: * `document` (default): One Document format per row. Each document must have a valid Document.id and one of Document.json_data or Document.struct_data. * `custom`: One custom data per row in arbitrary format that conforms to the defined Schema of the data store. This can only be used by Gen App Builder.",
           "type": "string"
         },
         "datasetId": {
@@ -2045,12 +2045,12 @@
       "id": "GoogleCloudDiscoveryengineV1alphaCompletionInfo",
       "properties": {
         "selectedPosition": {
-          "description": "End user selected CompleteQueryResponse.CompletionResult.suggestion position, starting from 0.",
+          "description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion position, starting from 0.",
           "format": "int32",
           "type": "integer"
         },
         "selectedSuggestion": {
-          "description": "End user selected CompleteQueryResponse.CompletionResult.suggestion.",
+          "description": "End user selected CompleteQueryResponse.QuerySuggestion.suggestion.",
           "type": "string"
         }
       },
@@ -2087,7 +2087,7 @@
           "type": "string"
         },
         "jsonData": {
-          "description": "The JSON string representation of the document. It should conform to the registered Schema.schema or an `INVALID_ARGUMENT` error is thrown.",
+          "description": "The JSON string representation of the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown.",
           "type": "string"
         },
         "name": {
@@ -2107,7 +2107,7 @@
             "description": "Properties of the object.",
             "type": "any"
           },
-          "description": "The structured JSON data for the document. It should conform to the registered Schema.schema or an `INVALID_ARGUMENT` error is thrown.",
+          "description": "The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown.",
           "type": "object"
         }
       },
@@ -2138,7 +2138,7 @@
           "type": "integer"
         },
         "uri": {
-          "description": "The Document url - only allowed for DataStores with content_config PUBLIC_WEBSITE.",
+          "description": "The Document URI - only allowed for website data stores.",
           "type": "string"
         }
       },
@@ -2149,7 +2149,7 @@
       "id": "GoogleCloudDiscoveryengineV1alphaGcsSource",
       "properties": {
         "dataSchema": {
-          "description": "The schema to use when parsing the data from the source. Supported values for document imports: * `document` (default): One JSON Document per line. Each document must have a valid Document.id. * `content`: Unstructured data (e.g. PDF, HTML). Each file matched by `input_uris` will become a document, with the ID set to the first 128 bits of SHA256(URI) encoded as a hex string. * `custom`: One custom data JSON per row in arbitrary format that conforms the defined Schema of the data store. This can only be used by the GENERIC Data Store vertical. * `csv`: A CSV file with header conforming the defined Schema of the data store. Each entry after the header will be imported as a Document. This can only be used by the GENERIC Data Store vertical. Supported values for user even imports: * `user_event` (default): One JSON UserEvent per line.",
+          "description": "The schema to use when parsing the data from the source. Supported values for document imports: * `document` (default): One JSON Document per line. Each document must have a valid Document.id. * `content`: Unstructured data (e.g. PDF, HTML). Each file matched by `input_uris` becomes a document, with the ID set to the first 128 bits of SHA256(URI) encoded as a hex string. * `custom`: One custom data JSON per row in arbitrary format that conforms to the defined Schema of the data store. This can only be used by Gen App Builder. * `csv`: A CSV file with header conforming to the defined Schema of the data store. Each entry after the header is imported as a Document. This can only be used by Gen App Builder. Supported values for user even imports: * `user_event` (default): One JSON UserEvent per line.",
           "type": "string"
         },
         "inputUris": {
@@ -2163,7 +2163,7 @@
       "type": "object"
     },
     "GoogleCloudDiscoveryengineV1alphaImportDocumentsMetadata": {
-      "description": "Metadata related to the progress of the ImportDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.",
+      "description": "Metadata related to the progress of the ImportDocuments operation. This is returned by the google.longrunning.Operation.metadata field.",
       "id": "GoogleCloudDiscoveryengineV1alphaImportDocumentsMetadata",
       "properties": {
         "createTime": {
@@ -2194,7 +2194,7 @@
       "id": "GoogleCloudDiscoveryengineV1alphaImportDocumentsRequest",
       "properties": {
         "autoGenerateIds": {
-          "description": "Whether to automatically generate IDs for the documents if absent. If set to `true`, Document.ids are automatically generated based on the hash of the payload, where IDs may not be consistent during multiple imports. In which case ReconciliationMode.FULL is highly recommended to avoid duplicate contents. If unset or set to `false`, Document.ids have to be specified using id_field, otherwises, documents without IDs will fail to be imported. Only set this field when using GcsSource or BigQuerySource, and when GcsSource.data_schema or BigQuerySource.data_schema is `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown.",
+          "description": "Whether to automatically generate IDs for the documents if absent. If set to `true`, Document.ids are automatically generated based on the hash of the payload, where IDs may not be consistent during multiple imports. In which case ReconciliationMode.FULL is highly recommended to avoid duplicate contents. If unset or set to `false`, Document.ids have to be specified using id_field, otherwise, documents without IDs fail to be imported. Only set this field when using GcsSource or BigQuerySource, and when GcsSource.data_schema or BigQuerySource.data_schema is `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown.",
           "type": "boolean"
         },
         "bigquerySource": {
@@ -2210,7 +2210,7 @@
           "description": "Cloud Storage location for the input content."
         },
         "idField": {
-          "description": "The field in the Cloud Storage and BigQuery sources that indicates the unique IDs of the documents. For GcsSource it is the key of the JSON field. For instance, `my_id` for JSON `{\"my_id\": \"some_uuid\"}`. For BigQuerySource it is the column name of the BigQuery table where the unique ids are stored. The values of the JSON field or the BigQuery column will be used as the Document.ids. The JSON field or the BigQuery column must be of string type, and the values must be set as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters. Otherwise, documents without valid IDs will fail to be imported. Only set this field when using GcsSource or BigQuerySource, and when GcsSource.data_schema or BigQuerySource.data_schema is `custom`. And only set this field when auto_generate_ids is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown. If it is unset, a default value `_id` is used when importing from the allowed data sources.",
+          "description": "The field in the Cloud Storage and BigQuery sources that indicates the unique IDs of the documents. For GcsSource it is the key of the JSON field. For instance, `my_id` for JSON `{\"my_id\": \"some_uuid\"}`. For BigQuerySource it is the column name of the BigQuery table where the unique ids are stored. The values of the JSON field or the BigQuery column are used as the Document.ids. The JSON field or the BigQuery column must be of string type, and the values must be set as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters. Otherwise, documents without valid IDs fail to be imported. Only set this field when using GcsSource or BigQuerySource, and when GcsSource.data_schema or BigQuerySource.data_schema is `custom`. And only set this field when auto_generate_ids is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown. If it is unset, a default value `_id` is used when importing from the allowed data sources.",
           "type": "string"
         },
         "inlineSource": {
@@ -2225,7 +2225,7 @@
             "FULL"
           ],
           "enumDescriptions": [
-            "Defaults to INCREMENTAL.",
+            "Defaults to `INCREMENTAL`.",
             "Inserts new documents or updates existing documents.",
             "Calculates diff and replaces the entire document dataset. Existing documents may be deleted if they are not present in the source location."
           ],
@@ -2271,14 +2271,14 @@
       "id": "GoogleCloudDiscoveryengineV1alphaImportErrorConfig",
       "properties": {
         "gcsPrefix": {
-          "description": "Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+          "description": "Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
           "type": "string"
         }
       },
       "type": "object"
     },
     "GoogleCloudDiscoveryengineV1alphaImportUserEventsMetadata": {
-      "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+      "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
       "id": "GoogleCloudDiscoveryengineV1alphaImportUserEventsMetadata",
       "properties": {
         "createTime": {
@@ -2409,11 +2409,11 @@
       "id": "GoogleCloudDiscoveryengineV1alphaPageInfo",
       "properties": {
         "pageCategory": {
-          "description": "The most specific category associated with a category page. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, please replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategory\" : \"Sales > 2017 Black Friday Deals\". Required for `view-category-page` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.",
+          "description": "The most specific category associated with a category page. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, please replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: `\"pageCategory\" : \"Sales > 2017 Black Friday Deals\"`. Required for `view-category-page` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.",
           "type": "string"
         },
         "pageviewId": {
-          "description": "A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.",
+          "description": "A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageview_id` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.",
           "type": "string"
         },
         "referrerUri": {
@@ -2684,16 +2684,16 @@
       "id": "GoogleCloudDiscoveryengineV1alphaSearchInfo",
       "properties": {
         "offset": {
-          "description": "An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an INVALID_ARGUMENT is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.",
+          "description": "An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See SearchRequest.offset for definition. If this field is negative, an `INVALID_ARGUMENT` is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.",
           "format": "int32",
           "type": "integer"
         },
         "orderBy": {
-          "description": "The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.",
+          "description": "The order in which products are returned, if applicable. See SearchRequest.order_by for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.",
           "type": "string"
         },
         "searchQuery": {
-          "description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.",
+          "description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an `INVALID_ARGUMENT` error is returned.",
           "type": "string"
         }
       },
@@ -2704,7 +2704,7 @@
       "id": "GoogleCloudDiscoveryengineV1alphaTargetSite",
       "properties": {
         "exactMatch": {
-          "description": "Input only. If set to false, an uri_pattern will be generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern will be generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern will always be normalized to generate the uri pattern to be used by the search engine.",
+          "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.",
           "type": "boolean"
         },
         "generatedUriPattern": {
@@ -2718,7 +2718,7 @@
           "type": "string"
         },
         "providedUriPattern": {
-          "description": "Required. Input only. The user provided uri pattern from which the `generated_uri_pattern` is generated.",
+          "description": "Required. Input only. The user provided URI pattern from which the `generated_uri_pattern` is generated.",
           "type": "string"
         },
         "type": {
@@ -2787,16 +2787,16 @@
           "additionalProperties": {
             "$ref": "GoogleCloudDiscoveryengineV1alphaCustomAttribute"
           },
-          "description": "Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is ` traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.",
+          "description": "Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.",
           "type": "object"
         },
         "attributionToken": {
-          "description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * PredictResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. * CompleteQueryResponse.attribution_token for events that are the result of CompletionService.CompleteQuery. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass PredictResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the PredictResponse.attribution_token to this field.",
+          "description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * RecommendResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass RecommendResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the RecommendResponse.attribution_token to this field.",
           "type": "string"
         },
         "completionInfo": {
           "$ref": "GoogleCloudDiscoveryengineV1alphaCompletionInfo",
-          "description": "CompleteQuery API details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
+          "description": "CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
         },
         "directUserRequest": {
           "description": "Should set to true if the request is made directly from the end user, in which case the UserEvent.user_info.user_agent can be populated from the HTTP request. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events). This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent.",
@@ -2819,7 +2819,7 @@
           "type": "string"
         },
         "filter": {
-          "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendationService.RecommendRequest, this field may be populated directly from RecommendationService.RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.",
+          "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendationService.RecommendRequest, this field may be populated directly from RecommendationService.RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
           "type": "string"
         },
         "mediaInfo": {
@@ -2843,7 +2843,7 @@
         },
         "searchInfo": {
           "$ref": "GoogleCloudDiscoveryengineV1alphaSearchInfo",
-          "description": "Search API details related to the event. This field should be set for `search` event."
+          "description": "SearchService.Search details related to the event. This field should be set for `search` event."
         },
         "sessionId": {
           "description": "A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add UserEvent.user_pseudo_id as prefix.",
@@ -2865,7 +2865,7 @@
           "description": "Information about the end user."
         },
         "userPseudoId": {
-          "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Do not set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. The field should not contain PII or user-data. We recommend to use Google Analytics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.",
+          "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Do not set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. The field should not contain PII or user-data. We recommend to use Google Analytics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.",
           "type": "string"
         }
       },
@@ -2876,7 +2876,7 @@
       "id": "GoogleCloudDiscoveryengineV1alphaUserInfo",
       "properties": {
         "userAgent": {
-          "description": "User agent as included in the HTTP header. Required for getting SearchResponse.sponsored_results. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.",
+          "description": "User agent as included in the HTTP header. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.",
           "type": "string"
         },
         "userId": {
@@ -2887,7 +2887,7 @@
       "type": "object"
     },
     "GoogleCloudDiscoveryengineV1betaImportDocumentsMetadata": {
-      "description": "Metadata related to the progress of the ImportDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.",
+      "description": "Metadata related to the progress of the ImportDocuments operation. This is returned by the google.longrunning.Operation.metadata field.",
       "id": "GoogleCloudDiscoveryengineV1betaImportDocumentsMetadata",
       "properties": {
         "createTime": {
@@ -2936,14 +2936,14 @@
       "id": "GoogleCloudDiscoveryengineV1betaImportErrorConfig",
       "properties": {
         "gcsPrefix": {
-          "description": "Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+          "description": "Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
           "type": "string"
         }
       },
       "type": "object"
     },
     "GoogleCloudDiscoveryengineV1betaImportUserEventsMetadata": {
-      "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+      "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
       "id": "GoogleCloudDiscoveryengineV1betaImportUserEventsMetadata",
       "properties": {
         "createTime": {