chore: Update discovery artifacts (#1335)

## Discovery Artifact Change Summary:
alertcenterv1beta1[ [More details]](1cf2d15)
dataprocv1[ [More details]](5e0b5ac)
filev1beta1[ [More details]](f9837f0)
retailv2alpha[ [More details]](16b9239)

feat(alertcenter): update the api
chore(assuredworkloads): update the api
chore(bigqueryconnection): update the api
chore(classroom): update the api
chore(datamigration): update the api
feat(dataproc): update the api
chore(eventarc): update the api
feat(file): update the api
chore(playablelocations): update the api
feat(retail): update the api
chore(searchconsole): update the api
chore(servicecontrol): update the api
chore(speech): update the api
chore(vectortile): update the api
chore(docs): Add new discovery artifacts and reference documents

Author: yoshi-code-bot

docs/dyn/datastore_v1beta3.projects.html

@@ -119,6 +119,7 @@ <h3>Method Details</h3>
     &quot;a_key&quot;: &quot;A String&quot;,
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
+  &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;sourceFileShare&quot;: &quot;A String&quot;, # Name of the file share in the source Cloud Filestore instance that the backup is created from.
   &quot;sourceInstance&quot;: &quot;A String&quot;, # The resource name of the source Cloud Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
   &quot;sourceInstanceTier&quot;: &quot;A String&quot;, # Output only. The service tier of the source Cloud Filestore instance that this backup is created from.
@@ -214,6 +215,7 @@ <h3>Method Details</h3>
     &quot;a_key&quot;: &quot;A String&quot;,
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
+  &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;sourceFileShare&quot;: &quot;A String&quot;, # Name of the file share in the source Cloud Filestore instance that the backup is created from.
   &quot;sourceInstance&quot;: &quot;A String&quot;, # The resource name of the source Cloud Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
   &quot;sourceInstanceTier&quot;: &quot;A String&quot;, # Output only. The service tier of the source Cloud Filestore instance that this backup is created from.
@@ -251,6 +253,7 @@ <h3>Method Details</h3>
         &quot;a_key&quot;: &quot;A String&quot;,
       },
       &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
+      &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
       &quot;sourceFileShare&quot;: &quot;A String&quot;, # Name of the file share in the source Cloud Filestore instance that the backup is created from.
       &quot;sourceInstance&quot;: &quot;A String&quot;, # The resource name of the source Cloud Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
       &quot;sourceInstanceTier&quot;: &quot;A String&quot;, # Output only. The service tier of the source Cloud Filestore instance that this backup is created from.
@@ -297,6 +300,7 @@ <h3>Method Details</h3>
     &quot;a_key&quot;: &quot;A String&quot;,
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
+  &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
   &quot;sourceFileShare&quot;: &quot;A String&quot;, # Name of the file share in the source Cloud Filestore instance that the backup is created from.
   &quot;sourceInstance&quot;: &quot;A String&quot;, # The resource name of the source Cloud Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
   &quot;sourceInstanceTier&quot;: &quot;A String&quot;, # Output only. The service tier of the source Cloud Filestore instance that this backup is created from.

docs/dyn/file_v1beta1.projects.locations.backups.html

@@ -126,7 +126,7 @@ <h3>Method Details</h3>
     &quot;a_key&quot;: &quot;A String&quot;,
   },
   &quot;name&quot;: &quot;A String&quot;, # Immutable. The name of a Hub resource.
-  &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes. This field is deprecated and will not be included in future API versions. Call ListSpokes on each region instead.
+  &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes
     &quot;A String&quot;,
   ],
   &quot;state&quot;: &quot;A String&quot;, # Output only. The current lifecycle state of this Hub.
@@ -222,7 +222,7 @@ <h3>Method Details</h3>
     &quot;a_key&quot;: &quot;A String&quot;,
   },
   &quot;name&quot;: &quot;A String&quot;, # Immutable. The name of a Hub resource.
-  &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes. This field is deprecated and will not be included in future API versions. Call ListSpokes on each region instead.
+  &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes
     &quot;A String&quot;,
   ],
   &quot;state&quot;: &quot;A String&quot;, # Output only. The current lifecycle state of this Hub.
@@ -306,7 +306,7 @@ <h3>Method Details</h3>
         &quot;a_key&quot;: &quot;A String&quot;,
       },
       &quot;name&quot;: &quot;A String&quot;, # Immutable. The name of a Hub resource.
-      &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes. This field is deprecated and will not be included in future API versions. Call ListSpokes on each region instead.
+      &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes
         &quot;A String&quot;,
       ],
       &quot;state&quot;: &quot;A String&quot;, # Output only. The current lifecycle state of this Hub.
@@ -351,7 +351,7 @@ <h3>Method Details</h3>
     &quot;a_key&quot;: &quot;A String&quot;,
   },
   &quot;name&quot;: &quot;A String&quot;, # Immutable. The name of a Hub resource.
-  &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes. This field is deprecated and will not be included in future API versions. Call ListSpokes on each region instead.
+  &quot;spokes&quot;: [ # Output only. A list of the URIs of all attached spokes
     &quot;A String&quot;,
   ],
   &quot;state&quot;: &quot;A String&quot;, # Output only. The current lifecycle state of this Hub.

docs/dyn/firestore_v1.projects.databases.documents.html

@@ -146,7 +146,7 @@ <h3>Method Details</h3>
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
   filter: string, A filter to narrow down results to a preferred subset. The filtering language accepts strings like &quot;displayName=tokyo&quot;, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
-  pageSize: integer, The maximum number of results to return. If not set, the service selects a default.
+  pageSize: integer, The maximum number of results to return. If not set, the service will select a default.
   pageToken: string, A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
   x__xgafv: string, V1 error format.
     Allowed values

docs/dyn/networkconnectivity_v1alpha1.projects.locations.global_.hubs.html

@@ -105,7 +105,7 @@ <h3>Method Details</h3>
   &quot;params&quot;: { # Additional domain specific parameters for the predictions. Allowed values: * `returnProduct`: Boolean. If set to true, the associated product object will be returned in the `results.metadata` field in the prediction response. * `returnScore`: Boolean. If set to true, the prediction &#x27;score&#x27; corresponding to each returned product will be set in the `results.metadata` field in the prediction response. The given &#x27;score&#x27; indicates the probability of an product being clicked/purchased given the user&#x27;s context and history. * `strictFiltering`: Boolean. True by default. If set to false, the service will return generic (unfiltered) popular products instead of empty if your filter blocks all prediction results.
     &quot;a_key&quot;: &quot;&quot;,
   },
-  &quot;userEvent&quot;: { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website. # Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won&#x27;t be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging.
+  &quot;userEvent&quot;: { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website. Next tag: 22 # Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won&#x27;t be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging.
     &quot;attributes&quot;: { # Extra user event features to include in the recommendation model. The key must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. For product recommendation, an example of extra user information is traffic_channel, i.e. how user arrives at the site. Users can arrive at the site by coming to the site directly, or coming through Google search, and etc.
       &quot;a_key&quot;: { # A custom attribute that is not explicitly modeled in Product.
         &quot;numbers&quot;: [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is &quot;lengths_cm&quot;. At most 400 values are allowed.Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.

docs/dyn/networkconnectivity_v1alpha1.projects.locations.html

@@ -155,7 +155,7 @@ <h3>Method Details</h3>
     },
     &quot;userEventInlineSource&quot;: { # The inline source for the input config for ImportUserEvents method. # Required. The Inline source for the input content for UserEvents.
       &quot;userEvents&quot;: [ # Required. A list of user events to import. Recommended max of 10k items.
-        { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website.
+        { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website. Next tag: 22
           &quot;attributes&quot;: { # Extra user event features to include in the recommendation model. The key must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. For product recommendation, an example of extra user information is traffic_channel, i.e. how user arrives at the site. Users can arrive at the site by coming to the site directly, or coming through Google search, and etc.
             &quot;a_key&quot;: { # A custom attribute that is not explicitly modeled in Product.
               &quot;numbers&quot;: [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is &quot;lengths_cm&quot;. At most 400 values are allowed.Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
@@ -369,7 +369,7 @@ <h3>Method Details</h3>
   body: object, The request body.
     The object takes the form of:
 
-{ # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website.
+{ # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website. Next tag: 22
   &quot;attributes&quot;: { # Extra user event features to include in the recommendation model. The key must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. For product recommendation, an example of extra user information is traffic_channel, i.e. how user arrives at the site. Users can arrive at the site by coming to the site directly, or coming through Google search, and etc.
     &quot;a_key&quot;: { # A custom attribute that is not explicitly modeled in Product.
       &quot;numbers&quot;: [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is &quot;lengths_cm&quot;. At most 400 values are allowed.Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
@@ -464,7 +464,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website.
+    { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website. Next tag: 22
   &quot;attributes&quot;: { # Extra user event features to include in the recommendation model. The key must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. For product recommendation, an example of extra user information is traffic_channel, i.e. how user arrives at the site. Users can arrive at the site by coming to the site directly, or coming through Google search, and etc.
     &quot;a_key&quot;: { # A custom attribute that is not explicitly modeled in Product.
       &quot;numbers&quot;: [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is &quot;lengths_cm&quot;. At most 400 values are allowed.Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.

docs/dyn/retail_v2.projects.locations.catalogs.placements.html

@@ -105,7 +105,7 @@ <h3>Method Details</h3>
   &quot;params&quot;: { # Additional domain specific parameters for the predictions. Allowed values: * `returnProduct`: Boolean. If set to true, the associated product object will be returned in the `results.metadata` field in the prediction response. * `returnScore`: Boolean. If set to true, the prediction &#x27;score&#x27; corresponding to each returned product will be set in the `results.metadata` field in the prediction response. The given &#x27;score&#x27; indicates the probability of an product being clicked/purchased given the user&#x27;s context and history. * `strictFiltering`: Boolean. True by default. If set to false, the service will return generic (unfiltered) popular products instead of empty if your filter blocks all prediction results.
     &quot;a_key&quot;: &quot;&quot;,
   },
-  &quot;userEvent&quot;: { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website. # Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won&#x27;t be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging.
+  &quot;userEvent&quot;: { # UserEvent captures all metadata information Retail API needs to know about how end users interact with customers&#x27; website. Next tag: 22 # Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won&#x27;t be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging.
     &quot;attributes&quot;: { # Extra user event features to include in the recommendation model. The key must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. For product recommendation, an example of extra user information is traffic_channel, i.e. how user arrives at the site. Users can arrive at the site by coming to the site directly, or coming through Google search, and etc.
       &quot;a_key&quot;: { # A custom attribute that is not explicitly modeled in Product.
         &quot;numbers&quot;: [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is &quot;lengths_cm&quot;. At most 400 values are allowed.Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
@@ -182,6 +182,7 @@ <h3>Method Details</h3>
     },
     &quot;referrerUri&quot;: &quot;A String&quot;, # The referrer URL of the current page. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
     &quot;searchQuery&quot;: &quot;A String&quot;, # The user&#x27;s search query. 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 page_categories is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
+    &quot;sessionId&quot;: &quot;A String&quot;, # Represents the user sessions to aggregate user behavior within a time period. If not set, heuristics will be used to autogenerate one.
     &quot;uri&quot;: &quot;A String&quot;, # Complete URL (window.location.href) of the user&#x27;s current page. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically. Maximum length 5,000 characters.
     &quot;userInfo&quot;: { # Information of an end user. # User information.
       &quot;directUserRequest&quot;: True or False, # True if the request is made directly from the end user, in which case the ip_address and 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.