google-apis-apigee_v1 0.25.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56e1f90809c2a70ad4ecf7314b31fcf448661dac238e949599fe42622eba128e
-  data.tar.gz: 848024b772549599b6c1807af6b99cefe8c526b2fee89554a1c1ca12fa8cecb3
+  metadata.gz: d5df0c3830c56bebf4f19e70ccd3b789acfbfe3356992cb6ac79469315af800d
+  data.tar.gz: 3a6468bb3d87b35f80bc73fa8d88a71719c93f7edd5af09671ea3270d9e917fb
 SHA512:
-  metadata.gz: 2a872225bf8b28f0f5e6b4c9b5a3467aae8c49b625eea9a26d2f277782afded89cf0ac180db0e9aad9142cc5a47baa02363e59ca449bd463eabe357e49775b6e
-  data.tar.gz: 18ae1dfae33c49ddfbb7622acf2c1ff0c1aff9022435624688fd6f0cc31f64fd2a7e1cddafe554f17a4a0ff58e0925197e7320d9108ddd5c215e7392828f9120
+  metadata.gz: '06298b0173f747cb598817a3be4b2567295c5fe2bfd40bb61d766e439dfdc823e7088268fbebc379af78a6bbedb484e1286f8d4cbc9c7cad5b9789d3a51bf15b'
+  data.tar.gz: 5a7bdc9dd72588e591b0c9f0401c9ecf55dc026a675cb81ee08b6e9af6fb5cb603f1828309a2fe5152d496b3d5284948b06f2ddb8365a8a2fe0ebd9ac254c804

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-apigee_v1
 
+### v0.26.0 (2021-11-03)
+
+* Regenerated from discovery document revision 20211101
+
 ### v0.25.0 (2021-10-26)
 
 * Regenerated from discovery document revision 20211021

data/lib/google/apis/apigee_v1/classes.rb

@@ -2859,16 +2859,16 @@ module Google
         end
       end
       
-      # This message type encapsulates a metric grouped by dimension.
+      # Encapsulates a metric grouped by dimension.
       class GoogleCloudApigeeV1DimensionMetric
         include Google::Apis::Core::Hashable
       
-        # This field contains a list of metrics.
+        # List of metrics.
         # Corresponds to the JSON property `metrics`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Metric>]
         attr_accessor :metrics
       
-        # This field contains the name of the dimension.
+        # Name of the dimension.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -4647,7 +4647,7 @@ module Google
         end
       end
       
-      # This message type encapsulates additional information about query execution.
+      # Encapsulates additional information about query execution.
       class GoogleCloudApigeeV1Metadata
         include Google::Apis::Core::Hashable
       
@@ -4656,10 +4656,10 @@ module Google
         # @return [Array<String>]
         attr_accessor :errors
       
-        # List of additional information such as data source, if result was truncated
-        # etc. E.g "notices": [ "Source:Postgres", "PG Host:uappg0rw.e2e.apigeeks.net", "
-        # query served by:4b64601e-40de-4eb1-bfb9-eeee7ac929ed", "Table used: edge.api.
-        # uapgroup2.agg_api" ]
+        # List of additional information such as data source, if result was truncated.
+        # For example: ``` "notices": [ "Source:Postgres", "PG Host:uappg0rw.e2e.
+        # apigeeks.net", "query served by:4b64601e-40de-4eb1-bfb9-eeee7ac929ed", "Table
+        # used: edge.api.uapgroup2.agg_api" ]```
         # Corresponds to the JSON property `notices`
         # @return [Array<String>]
         attr_accessor :notices
@@ -4675,20 +4675,20 @@ module Google
         end
       end
       
-      # This message type encapsulates the metric data point. Example: ` "name": "sum(
+      # Encapsulates the metric data point. For example: ```` "name": "sum(
       # message_count)", "values" : [ ` "timestamp": 1549004400000, "value": "39.0" `,
-      # ` "timestamp" : 1548997200000, "value" : "0.0" ` ] ` or ` "name": "sum(
-      # message_count)", "values" : ["39.0"] `
+      # ` "timestamp" : 1548997200000, "value" : "0.0" ` ] ```` or ```` "name": "sum(
+      # message_count)", "values" : ["39.0"] ````
       class GoogleCloudApigeeV1Metric
         include Google::Apis::Core::Hashable
       
-        # This field contains the metric name.
+        # Metric name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # List of metric values. Possible value format: "values":["39.0"] or "values":[ `
-        # "value": "39.0", "timestamp": 1232434354` ]
+        # List of metric values. Possible value formats include: `"values":["39.0"]` or `
+        # "values":[ ` "value": "39.0", "timestamp": 1232434354` ]`
         # Corresponds to the JSON property `values`
         # @return [Array<Object>]
         attr_accessor :values
@@ -4937,7 +4937,7 @@ module Google
       class GoogleCloudApigeeV1OptimizedStats
         include Google::Apis::Core::Hashable
       
-        # This message type encapsulates a response format for Js Optimized Scenario.
+        # Encapsulates a response format for JavaScript Optimized Scenario.
         # Corresponds to the JSON property `Response`
         # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1OptimizedStatsResponse]
         attr_accessor :response
@@ -4952,11 +4952,11 @@ module Google
         end
       end
       
-      # This message type encapsulates a data node as represented below: ` "identifier"
-      # : ` "names": [ "apiproxy" ], "values": [ "sirjee" ] `, "metric": [ ` "env": "
-      # prod", "name": "sum(message_count)", "values": [ 36.0 ] ` ] ` OR ` "env": "
-      # prod", "name": "sum(message_count)", "values": [ 36.0 ] ` Depending on whether
-      # a dimension is present in the query or not the data node type can be a simple
+      # Encapsulates a data node as represented below: ``` ` "identifier": ` "names": [
+      # "apiproxy" ], "values": [ "sirjee" ] `, "metric": [ ` "env": "prod", "name": "
+      # sum(message_count)", "values": [ 36.0 ] ` ] ```` or ``` ` "env": "prod", "name"
+      # : "sum(message_count)", "values": [ 36.0 ] ```` Depending on whether a
+      # dimension is present in the query or not the data node type can be a simple
       # metric value or dimension identifier with list of metrics.
       class GoogleCloudApigeeV1OptimizedStatsNode
         include Google::Apis::Core::Hashable
@@ -4976,33 +4976,32 @@ module Google
         end
       end
       
-      # This message type encapsulates a response format for Js Optimized Scenario.
+      # Encapsulates a response format for JavaScript Optimized Scenario.
       class GoogleCloudApigeeV1OptimizedStatsResponse
         include Google::Apis::Core::Hashable
       
-        # This field contains a list of time unit values. Time unit refers to an epoch
-        # timestamp value.
+        # List of time unit values. Time unit refers to an epoch timestamp value.
         # Corresponds to the JSON property `TimeUnit`
         # @return [Array<Fixnum>]
         attr_accessor :time_unit
       
-        # This message type encapsulates additional information about query execution.
+        # Encapsulates additional information about query execution.
         # Corresponds to the JSON property `metaData`
         # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Metadata]
         attr_accessor :meta_data
       
-        # This ia a boolean field to indicate if the results were truncated based on the
+        # Boolean flag that indicates whether the results were truncated based on the
         # limit parameter.
         # Corresponds to the JSON property `resultTruncated`
         # @return [Boolean]
         attr_accessor :result_truncated
         alias_method :result_truncated?, :result_truncated
       
-        # This message type encapsulates a data node as represented below: ` "identifier"
-        # : ` "names": [ "apiproxy" ], "values": [ "sirjee" ] `, "metric": [ ` "env": "
-        # prod", "name": "sum(message_count)", "values": [ 36.0 ] ` ] ` OR ` "env": "
-        # prod", "name": "sum(message_count)", "values": [ 36.0 ] ` Depending on whether
-        # a dimension is present in the query or not the data node type can be a simple
+        # Encapsulates a data node as represented below: ``` ` "identifier": ` "names": [
+        # "apiproxy" ], "values": [ "sirjee" ] `, "metric": [ ` "env": "prod", "name": "
+        # sum(message_count)", "values": [ 36.0 ] ` ] ```` or ``` ` "env": "prod", "name"
+        # : "sum(message_count)", "values": [ 36.0 ] ```` Depending on whether a
+        # dimension is present in the query or not the data node type can be a simple
         # metric value or dimension identifier with list of metrics.
         # Corresponds to the JSON property `stats`
         # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1OptimizedStatsNode]
@@ -6777,21 +6776,21 @@ module Google
         end
       end
       
-      # This message type encapsulates a stats response.
+      # Encapsulates a `stats` response.
       class GoogleCloudApigeeV1Stats
         include Google::Apis::Core::Hashable
       
-        # This field contains a list of query results on environment level.
+        # List of query results on the environment level.
         # Corresponds to the JSON property `environments`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1StatsEnvironmentStats>]
         attr_accessor :environments
       
-        # This field contains a list of query results grouped by host.
+        # List of query results grouped by host.
         # Corresponds to the JSON property `hosts`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1StatsHostStats>]
         attr_accessor :hosts
       
-        # This message type encapsulates additional information about query execution.
+        # Encapsulates additional information about query execution.
         # Corresponds to the JSON property `metaData`
         # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Metadata]
         attr_accessor :meta_data
@@ -6808,31 +6807,31 @@ module Google
         end
       end
       
-      # This message type encapsulates the environment wrapper: "environments": [ ` "
-      # metrics": [ ` "name": "sum(message_count)", "values": [ "2.52056245E8" ] ` ], "
-      # name": "prod" ` ]
+      # Encapsulates the environment wrapper: ``` "environments": [ ` "metrics": [ ` "
+      # name": "sum(message_count)", "values": [ "2.52056245E8" ] ` ], "name": "prod" `
+      # ]```
       class GoogleCloudApigeeV1StatsEnvironmentStats
         include Google::Apis::Core::Hashable
       
-        # This field contains the list of metrics grouped under dimensions.
+        # List of metrics grouped under dimensions.
         # Corresponds to the JSON property `dimensions`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1DimensionMetric>]
         attr_accessor :dimensions
       
         # In the final response, only one of the following fields will be present based
-        # on the dimensions provided. If no dimensions are provided, then only a top
-        # level metrics is provided. If dimensions are included, then there will be a
-        # top level dimensions field under environments which will contain metrics
-        # values and the dimension name. Example: "environments": [ ` "dimensions": [ ` "
+        # on the dimensions provided. If no dimensions are provided, then only top-level
+        # metrics is provided. If dimensions are included, then there will be a top-
+        # level dimensions field under environments which will contain metrics values
+        # and the dimension name. Example: ``` "environments": [ ` "dimensions": [ ` "
         # metrics": [ ` "name": "sum(message_count)", "values": [ "2.14049521E8" ] ` ], "
-        # name": "nit_proxy" ` ], "name": "prod" ` ] OR "environments": [ ` "metrics": [
-        # ` "name": "sum(message_count)", "values": [ "2.19026331E8" ] ` ], "name": "
-        # prod" ` ] This field contains the list of metric values.
+        # name": "nit_proxy" ` ], "name": "prod" ` ]``` or ```"environments": [ ` "
+        # metrics": [ ` "name": "sum(message_count)", "values": [ "2.19026331E8" ] ` ], "
+        # name": "prod" ` ]``` List of metric values.
         # Corresponds to the JSON property `metrics`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Metric>]
         attr_accessor :metrics
       
-        # 
+        # Name of the environment.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -6849,31 +6848,31 @@ module Google
         end
       end
       
-      # This message type encapsulates the hostname wrapper: "hosts": [ ` "metrics": [
-      # ` "name": "sum(message_count)", "values": [ "2.52056245E8" ] ` ], "name": "
-      # example.com" ` ]
+      # Encapsulates the hostname wrapper: ``` "hosts": [ ` "metrics": [ ` "name": "
+      # sum(message_count)", "values": [ "2.52056245E8" ] ` ], "name": "example.com" `
+      # ]```
       class GoogleCloudApigeeV1StatsHostStats
         include Google::Apis::Core::Hashable
       
-        # This field contains the list of metrics grouped under dimensions.
+        # List of metrics grouped under dimensions.
         # Corresponds to the JSON property `dimensions`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1DimensionMetric>]
         attr_accessor :dimensions
       
         # In the final response, only one of the following fields will be present based
-        # on the dimensions provided. If no dimensions are provided, then only a top
-        # level metrics is provided. If dimensions are included, then there will be a
-        # top level dimensions field under hostnames which will contain metrics values
-        # and the dimension name. Example: "hosts": [ ` "dimensions": [ ` "metrics": [ `
-        # "name": "sum(message_count)", "values": [ "2.14049521E8" ] ` ], "name": "
-        # nit_proxy" ` ], "name": "example.com" ` ] OR "hosts": [ ` "metrics": [ ` "name"
-        # : "sum(message_count)", "values": [ "2.19026331E8" ] ` ], "name": "example.com"
-        # ` ] This field contains the list of metric values.
+        # on the dimensions provided. If no dimensions are provided, then only the top-
+        # level metrics are provided. If dimensions are included, then there will be a
+        # top-level dimensions field under hostnames which will contain metrics values
+        # and the dimension name. Example: ``` "hosts": [ ` "dimensions": [ ` "metrics":
+        # [ ` "name": "sum(message_count)", "values": [ "2.14049521E8" ] ` ], "name": "
+        # nit_proxy" ` ], "name": "example.com" ` ]``` OR ```"hosts": [ ` "metrics": [ `
+        # "name": "sum(message_count)", "values": [ "2.19026331E8" ] ` ], "name": "
+        # example.com" ` ]``` List of metric values.
         # Corresponds to the JSON property `metrics`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Metric>]
         attr_accessor :metrics
       
-        # This field contains the hostname used in query.
+        # Hostname used in query.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

data/lib/google/apis/apigee_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module ApigeeV1
       # Version of the google-apis-apigee_v1 gem
-      GEM_VERSION = "0.25.0"
+      GEM_VERSION = "0.26.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20211021"
+      REVISION = "20211101"
     end
   end
 end

data/lib/google/apis/apigee_v1/service.rb

@@ -5685,58 +5685,55 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # This api is similar to GetStats except that the response is less verbose. In
-        # the current scheme, a query parameter _optimized instructs Edge Analytics to
-        # change the response but since this behavior is not possible with protocol
-        # buffer and since this parameter is predominantly used by Edge UI, we are
-        # introducing a separate api.
-        # @param [String] name
-        #   Required. The resource name for which the interactive query will be executed.
-        #   Must be of the form `organizations/`organization_id`/environments/`
-        #   environment_id/optimizedStats/`dimensions`` Dimensions let you view metrics in
-        #   meaningful groupings. E.g. apiproxy, target_host. The value of dimensions
-        #   should be comma separated list as shown below `organizations/`org`/
-        #   environments/`env`/optimizedStats/apiproxy,request_verb`
+        # Similar to GetStats except that the response is less verbose.
+        # @param [String] name
+        #   Required. Resource name for which the interactive query will be executed. Use
+        #   the following format in your request: `organizations/`org`/environments/`env`/
+        #   optimizedStats/`dimensions`` Dimensions let you view metrics in meaningful
+        #   groupings, such as `apiproxy`, `target_host`. The value of `dimensions` should
+        #   be a comma-separated list as shown below: `organizations/`org`/environments/`
+        #   env`/optimizedStats/apiproxy,request_verb`
         # @param [String] accuracy
-        #   Legacy field: not used anymore.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] agg_table
-        #   If customers want to query custom aggregate tables, then this parameter can be
-        #   used to specify the table name. If this parameter is skipped, then Edge Query
-        #   will try to retrieve the data from fact tables which will be expensive.
+        #   Table name used to query custom aggregate tables. If this parameter is skipped,
+        #   then Apigee will try to retrieve the data from fact tables which will be
+        #   expensive.
         # @param [String] filter
-        #   Enables drill-down on specific dimension values.
+        #   Filter that enables you to drill-down on specific dimension values.
         # @param [String] limit
-        #   This parameter is used to limit the number of result items. Default and the
-        #   max value is 14400.
+        #   Maximum number of result items to return. The default and maximum value that
+        #   can be returned is 14400.
         # @param [String] offset
-        #   Use offset with limit to enable pagination of results. For example, to display
-        #   results 11-20, set limit to '10' and offset to '10'.
+        #   Offset value. Use `offset` with `limit` to enable pagination of results. For
+        #   example, to display results 11-20, set limit to `10` and offset to `10`.
         # @param [Boolean] realtime
-        #   Legacy field: not used anymore.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] select
-        #   Required. The select parameter contains a comma separated list of metrics. E.g.
-        #   sum(message_count),sum(error_count)
+        #   Required. Comma-separated list of metrics. For example: `sum(message_count),
+        #   sum(error_count)`
         # @param [Boolean] sonar
-        #   This parameter routes the query to api monitoring service for last hour.
+        #   Routes the query to API Monitoring for the last hour.
         # @param [String] sort
-        #   This parameter specifies if the sort order should be ascending or descending
-        #   Supported values are DESC and ASC.
+        #   Flag that specifies whether the sort order should be ascending or descending.
+        #   Valid values include `DESC` and `ASC`.
         # @param [String] sortby
-        #   Comma separated list of columns to sort the final result.
+        #   Comma-separated list of columns to sort the final result.
         # @param [String] time_range
-        #   Required. Time interval for the interactive query. Time range is specified as
-        #   start~end E.g. 04/15/2017 00:00~05/15/2017 23:59
+        #   Required. Time interval for the interactive query. Time range is specified in
+        #   GMT as `start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`
         # @param [String] time_unit
-        #   A value of second, minute, hour, day, week, month. Time Unit specifies the
-        #   granularity of metrics returned.
+        #   Granularity of metrics returned. Valid values include: `second`, `minute`, `
+        #   hour`, `day`, `week`, or `month`.
         # @param [String] topk
-        #   Take 'top k' results from results, for example, to return the top 5 results '
-        #   topk=5'.
+        #   Top number of results to return. For example, to return the top 5 results, set
+        #   `topk=5`.
         # @param [Boolean] ts_ascending
-        #   Lists timestamps in ascending order if set to true. Recommend setting this
-        #   value to true if you are using sortby with sort=DESC.
+        #   Flag that specifies whether to list timestamps in ascending (`true`) or
+        #   descending (`false`) order. Apigee recommends setting this value to `true` if
+        #   you are using `sortby` with `sort=DESC`.
         # @param [String] tzo
-        #   This parameters contains the timezone offset value.
+        #   Timezone offset value.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -6464,58 +6461,58 @@ module Google
         
         # Retrieve metrics grouped by dimensions. The types of metrics you can retrieve
         # include traffic, message counts, API call latency, response size, and cache
-        # hits and counts. Dimensions let you view metrics in meaningful groups. The
-        # stats api does accept dimensions as path params. The dimensions are optional
-        # in which case the metrics are computed on the entire data for the given
-        # timerange.
-        # @param [String] name
-        #   Required. The resource name for which the interactive query will be executed.
-        #   Must be of the form `organizations/`organization_id`/environments/`
-        #   environment_id/stats/`dimensions`` Dimensions let you view metrics in
-        #   meaningful groupings. E.g. apiproxy, target_host. The value of dimensions
-        #   should be comma separated list as shown below `organizations/`org`/
-        #   environments/`env`/stats/apiproxy,request_verb`
+        # hits and counts. Dimensions let you view metrics in meaningful groups. You can
+        # optionally pass dimensions as path parameters to the `stats` API. If
+        # dimensions are not specified, the metrics are computed on the entire set of
+        # data for the given time range.
+        # @param [String] name
+        #   Required. Resource name for which the interactive query will be executed. Use
+        #   the following format in your request: `organizations/`org`/environments/`env`/
+        #   stats/`dimensions`` Dimensions let you view metrics in meaningful groupings,
+        #   such as `apiproxy` or `target_host`. The value of dimensions should be a comma-
+        #   separated list, as shown below: `organizations/`org`/environments/`env`/stats/
+        #   apiproxy,request_verb`
         # @param [String] accuracy
-        #   Legacy field: not used anymore. This field is present to support UI calls
-        #   which still use this parameter.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] agg_table
-        #   If customers want to query custom aggregate tables, then this parameter can be
-        #   used to specify the table name. If this parameter is skipped, then Edge Query
-        #   will try to retrieve the data from fact tables which will be expensive.
+        #   Table name used to query custom aggregate tables. If this parameter is skipped,
+        #   then Apigee will try to retrieve the data from fact tables which will be
+        #   expensive.
         # @param [String] filter
-        #   Enables drill-down on specific dimension values
+        #   Filter that enables you to drill down on specific dimension values.
         # @param [String] limit
-        #   This parameter is used to limit the number of result items. Default and the
-        #   max value is 14400.
+        #   Maximum number of result items to return. The default and maximum value that
+        #   can be returned is 14400.
         # @param [String] offset
-        #   Use offset with limit to enable pagination of results. For example, to display
-        #   results 11-20, set limit to '10' and offset to '10'.
+        #   Offset value. Use `offset` with `limit` to enable pagination of results. For
+        #   example, to display results 11-20, set limit to `10` and offset to `10`.
         # @param [Boolean] realtime
-        #   Legacy field: not used anymore.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] select
-        #   The select parameter contains a comma separated list of metrics. E.g. sum(
-        #   message_count),sum(error_count)
+        #   Comma-separated list of metrics. For example: `sum(message_count),sum(
+        #   error_count)`
         # @param [Boolean] sonar
-        #   This parameter routes the query to api monitoring service for last hour.
+        #   Routes the query to API Monitoring for the last hour.
         # @param [String] sort
-        #   This parameter specifies if the sort order should be ascending or descending
-        #   Supported values are DESC and ASC.
+        #   Flag that specifies whether the sort order should be ascending or descending.
+        #   Valid values include: `DESC` and `ASC`.
         # @param [String] sortby
-        #   Comma separated list of columns to sort the final result.
+        #   Comma-separated list of columns to sort the final result.
         # @param [String] time_range
-        #   Time interval for the interactive query. Time range is specified as start~end
-        #   E.g. 04/15/2017 00:00~05/15/2017 23:59
+        #   Time interval for the interactive query. Time range is specified in GMT as `
+        #   start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`
         # @param [String] time_unit
-        #   A value of second, minute, hour, day, week, month. Time Unit specifies the
-        #   granularity of metrics returned.
+        #   Granularity of metrics returned. Valid values include: `second`, `minute`, `
+        #   hour`, `day`, `week`, or` month`.
         # @param [String] topk
-        #   Take 'top k' results from results, for example, to return the top 5 results '
-        #   topk=5'.
+        #   Top number of results to return. For example, to return the top 5 results, set
+        #   `topk=5`.
         # @param [Boolean] ts_ascending
-        #   Lists timestamps in ascending order if set to true. Recommend setting this
-        #   value to true if you are using sortby with sort=DESC.
+        #   Flag that specifies whether to list timestamps in ascending (`true`) or
+        #   descending (`false`) order. Apigee recommends that you set this value to `true`
+        #   if you are using `sortby` with `sort=DESC`.
         # @param [String] tzo
-        #   This parameters contains the timezone offset value.
+        #   Timezone offset value.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -7070,51 +7067,52 @@ module Google
         # Retrieve metrics grouped by dimensions in host level. The types of metrics you
         # can retrieve include traffic, message counts, API call latency, response size,
         # and cache hits and counts. Dimensions let you view metrics in meaningful
-        # groups. The stats api does accept dimensions as path params. The dimensions
-        # are optional in which case the metrics are computed on the entire data for the
-        # given timerange.
-        # @param [String] name
-        #   Required. The resource name for which the interactive query will be executed.
-        #   Must be of the form `organizations/`organization_id`/hostStats/`dimensions``.
-        #   Dimensions let you view metrics in meaningful groupings. E.g. apiproxy,
-        #   target_host. The value of dimensions should be comma separated list as shown
-        #   below `organizations/`org`/hostStats/apiproxy,request_verb`
+        # groups. You can optionally pass dimensions as path parameters to the `stats`
+        # API. If dimensions are not specified, the metrics are computed on the entire
+        # set of data for the given time range.
+        # @param [String] name
+        #   Required. Resource name for which the interactive query will be executed. Use
+        #   the following format in your request: `organizations/`org`/hostStats/`
+        #   dimensions`` Dimensions let you view metrics in meaningful groupings, such as `
+        #   apiproxy`, `target_host`. The value of dimensions should be a comma-separated
+        #   list as shown below `organizations/`org`/hostStats/apiproxy,request_verb`
         # @param [String] accuracy
-        #   Legacy field: not used anymore.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] envgroup_hostname
-        #   Required. The hostname for which the interactive query will be executed.
+        #   Required. Hostname for which the interactive query will be executed.
         # @param [String] filter
-        #   Enables drill-down on specific dimension values.
+        #   Flag that enables drill-down on specific dimension values.
         # @param [String] limit
-        #   This parameter is used to limit the number of result items. Default and the
-        #   max value is 14400.
+        #   Maximum number of result items to return. The default and maximum value that
+        #   can be returned is 14400.
         # @param [String] offset
-        #   Use offset with limit to enable pagination of results. For example, to display
-        #   results 11-20, set limit to '10' and offset to '10'.
+        #   Offset value. Use `offset` with `limit` to enable pagination of results. For
+        #   example, to display results 11-20, set limit to `10` and offset to `10`.
         # @param [Boolean] realtime
-        #   Legacy field: not used anymore.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] select
-        #   The select parameter contains a comma separated list of metrics. E.g. sum(
-        #   message_count),sum(error_count)
+        #   Comma-separated list of metrics. For example: `sum(message_count),sum(
+        #   error_count)`
         # @param [String] sort
-        #   This parameter specifies if the sort order should be ascending or descending
-        #   Supported values are DESC and ASC.
+        #   Flag that specifies if the sort order should be ascending or descending. Valid
+        #   values are `DESC` and `ASC`.
         # @param [String] sortby
-        #   Comma separated list of columns to sort the final result.
+        #   Comma-separated list of columns to sort the final result.
         # @param [String] time_range
-        #   Time interval for the interactive query. Time range is specified as start~end
-        #   E.g. 04/15/2017 00:00~05/15/2017 23:59
+        #   Time interval for the interactive query. Time range is specified in GMT as `
+        #   start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`
         # @param [String] time_unit
-        #   A value of second, minute, hour, day, week, month. Time Unit specifies the
-        #   granularity of metrics returned.
+        #   Granularity of metrics returned. Valid values include: `second`, `minute`, `
+        #   hour`, `day`, `week`, or `month`.
         # @param [String] topk
-        #   Take 'top k' results from results, for example, to return the top 5 results '
-        #   topk=5'.
+        #   Top number of results to return. For example, to return the top 5 results, set
+        #   `topk=5`.
         # @param [Boolean] ts_ascending
-        #   Lists timestamps in ascending order if set to true. Recommend setting this
-        #   value to true if you are using sortby with sort=DESC.
+        #   Flag that specifies whether to list timestamps in ascending (`true`) or
+        #   descending (`false`) order. Apigee recommends that you set this value to `true`
+        #   if you are using `sortby` with `sort=DESC`.
         # @param [String] tzo
-        #   This parameters contains the timezone offset value.
+        #   Timezone offset value.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -7887,49 +7885,51 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # This api is similar to GetHostStats except that the response is less verbose.
+        # Similar to GetHostStats except that the response is less verbose.
         # @param [String] name
-        #   Required. The resource name for which the interactive query will be executed.
-        #   Must be of the form `organizations/`organization_id`/optimizedHostStats/`
-        #   dimensions``. Dimensions let you view metrics in meaningful groupings. E.g.
-        #   apiproxy, target_host. The value of dimensions should be comma separated list
-        #   as shown below `organizations/`org`/optimizedHostStats/apiproxy,request_verb`
+        #   Required. Resource name for which the interactive query will be executed. Use
+        #   the following format in your request: `organizations/`organization_id`/
+        #   optimizedHostStats/`dimensions`` Dimensions let you view metrics in meaningful
+        #   groupings, such as `apiproxy`, `target_host`. The value of dimensions should
+        #   be a comma-separated list as shown below: `organizations/`org`/
+        #   optimizedHostStats/apiproxy,request_verb`
         # @param [String] accuracy
-        #   Legacy field: not used anymore.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] envgroup_hostname
-        #   Required. The hostname for which the interactive query will be executed.
+        #   Required. Hostname for which the interactive query will be executed.
         # @param [String] filter
-        #   Enables drill-down on specific dimension values.
+        #   Filter that enables you to drill-down on specific dimension values.
         # @param [String] limit
-        #   This parameter is used to limit the number of result items. Default and the
-        #   max value is 14400.
+        #   Maximum number of result items to return. The default and maximum value that
+        #   can be returned is 14400.
         # @param [String] offset
-        #   Use offset with limit to enable pagination of results. For example, to display
-        #   results 11-20, set limit to '10' and offset to '10'.
+        #   Offset value. Use `offset` with `limit` to enable pagination of results. For
+        #   example, to display results 11-20, set limit to `10` and offset to `10`.
         # @param [Boolean] realtime
-        #   Legacy field: not used anymore.
+        #   No longer used by Apigee. Supported for backwards compatibility.
         # @param [String] select
-        #   Required. The select parameter contains a comma separated list of metrics. E.g.
-        #   sum(message_count),sum(error_count)
+        #   Required. Comma-separated list of metrics. For example: `sum(message_count),
+        #   sum(error_count)`
         # @param [String] sort
-        #   This parameter specifies if the sort order should be ascending or descending
-        #   Supported values are DESC and ASC.
+        #   Flag that specifies whether the sort order should be ascending or descending.
+        #   Valid values include `DESC` and `ASC`.
         # @param [String] sortby
-        #   Comma separated list of columns to sort the final result.
+        #   Comma-separated list of columns used to sort the final result.
         # @param [String] time_range
-        #   Required. Time interval for the interactive query. Time range is specified as
-        #   start~end. E.g 04/15/2017 00:00~05/15/2017 23:59.
+        #   Required. Time interval for the interactive query. Time range is specified in
+        #   GMT as `start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`.
         # @param [String] time_unit
-        #   A value of second, minute, hour, day, week, month. Time Unit specifies the
-        #   granularity of metrics returned.
+        #   Granularity of metrics returned. Valid values include: `second`, `minute`, `
+        #   hour`, `day`, `week`, or `month`.
         # @param [String] topk
-        #   Take 'top k' results from results, for example, to return the top 5 results '
-        #   topk=5'.
+        #   Top number of results to return. For example, to return the top 5 results, set
+        #   `topk=5`.
         # @param [Boolean] ts_ascending
-        #   Lists timestamps in ascending order if set to true. Recommend setting this
-        #   value to true if you are using sortby with sort=DESC.
+        #   Flag that specifies whether to list timestamps in ascending (`true`) or
+        #   descending (`false`) order. Apigee recommends that you set this value to `true`
+        #   if you are using `sortby` with `sort=DESC`.
         # @param [String] tzo
-        #   This parameters contains the timezone offset value.
+        #   Timezone offset value.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-apigee_v1
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-27 00:00:00.000000000 Z
+date: 2021-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-apigee_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-apigee_v1/v0.25.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-apigee_v1/v0.26.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-apigee_v1
 post_install_message: 
 rdoc_options: []