google-apis-apigee_v1 0.25.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56e1f90809c2a70ad4ecf7314b31fcf448661dac238e949599fe42622eba128e
-  data.tar.gz: 848024b772549599b6c1807af6b99cefe8c526b2fee89554a1c1ca12fa8cecb3
+  metadata.gz: b7553941e160f976a17757cc0d453e593ff8166fbf0fb57c9e81b473b52351aa
+  data.tar.gz: f418c01d6482b359d9fab980de5c1078533fdb46ae81ed2271e35d28e71b9881
 SHA512:
-  metadata.gz: 2a872225bf8b28f0f5e6b4c9b5a3467aae8c49b625eea9a26d2f277782afded89cf0ac180db0e9aad9142cc5a47baa02363e59ca449bd463eabe357e49775b6e
-  data.tar.gz: 18ae1dfae33c49ddfbb7622acf2c1ff0c1aff9022435624688fd6f0cc31f64fd2a7e1cddafe554f17a4a0ff58e0925197e7320d9108ddd5c215e7392828f9120
+  metadata.gz: e7246bcd7f167eb347398804a56f24dca232b67b23f2b97c1d8364182fffdcdfd27808f27fc46a42598e9126cb7c1d2d17d784d14306cf130825da234a918495
+  data.tar.gz: d78fbb643d698095ee46349cc6d371bd900d03f0786f2c0baef5e40ee94ad6480cfae355e717b8451e75ddc9d85a783b527e23c29c34ad74d82c4a9985566612

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release history for google-apis-apigee_v1
 
+### v0.29.0 (2021-12-07)
+
+* Regenerated from discovery document revision 20211203
+
+### v0.28.0 (2021-11-16)
+
+* Regenerated from discovery document revision 20211111
+
+### v0.27.0 (2021-11-10)
+
+* Regenerated from discovery document revision 20211108
+
+### 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

@@ -285,6 +285,25 @@ module Google
         end
       end
       
+      # Request for AdjustDeveloperBalance.
+      class GoogleCloudApigeeV1AdjustDeveloperBalanceRequest
+        include Google::Apis::Core::Hashable
+      
+        # Represents an amount of money with its currency type.
+        # Corresponds to the JSON property `adjustment`
+        # @return [Google::Apis::ApigeeV1::GoogleTypeMoney]
+        attr_accessor :adjustment
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @adjustment = args[:adjustment] if args.key?(:adjustment)
+        end
+      end
+      
       # Configuration for the Advanced API Ops add-on.
       class GoogleCloudApigeeV1AdvancedApiOpsConfig
         include Google::Apis::Core::Hashable
@@ -1510,7 +1529,7 @@ module Google
         attr_accessor :enabled
         alias_method :enabled?, :enabled
       
-        # Output only. Time at which the Connectors Platform add-on expires in in
+        # Output only. Time at which the Connectors Platform add-on expires in
         # milliseconds since epoch. If unspecified, the add-on will never expire.
         # Corresponds to the JSON property `expiresAt`
         # @return [Fixnum]
@@ -1567,7 +1586,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :scopes
       
-        # Status of the credential.
+        # Status of the credential. Valid values include `approved` or `revoked`.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -2859,16 +2878,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 +4666,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 +4675,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 +4694,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 +4956,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 +4971,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 +4995,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 +6795,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 +6826,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 +6867,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.29.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 = "20211203"
     end
   end
 end

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

@@ -76,6 +76,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudApigeeV1AdjustDeveloperBalanceRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudApigeeV1AdvancedApiOpsConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1280,6 +1286,14 @@ module Google
         end
       end
       
+      class GoogleCloudApigeeV1AdjustDeveloperBalanceRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :adjustment, as: 'adjustment', class: Google::Apis::ApigeeV1::GoogleTypeMoney, decorator: Google::Apis::ApigeeV1::GoogleTypeMoney::Representation
+      
+        end
+      end
+      
       class GoogleCloudApigeeV1AdvancedApiOpsConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -1767,7 +1767,8 @@ module Google
         # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1DataCollector] google_cloud_apigee_v1_data_collector_object
         # @param [String] data_collector_id
         #   ID of the data collector. Overrides any ID in the data collector resource.
-        #   Must begin with `dc_`.
+        #   Must be a string beginning with `dc_` that contains only letters, numbers, and
+        #   underscores.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3256,6 +3257,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Adjust the prepaid balance for the developer. This API will be used in
+        # scenarios where the developer has been under-charged or over-charged.
+        # @param [String] name
+        #   Required. Account balance for the developer. Use the following structure in
+        #   your request: `organizations/`org`/developers/`developer`/balance`
+        # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1AdjustDeveloperBalanceRequest] google_cloud_apigee_v1_adjust_developer_balance_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeveloperBalance] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeveloperBalance]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def adjust_organization_developer_balance(name, google_cloud_apigee_v1_adjust_developer_balance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:adjust', options)
+          command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1AdjustDeveloperBalanceRequest::Representation
+          command.request_object = google_cloud_apigee_v1_adjust_developer_balance_request_object
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeveloperBalance::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeveloperBalance
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Credits the account balance for the developer.
         # @param [String] name
         #   Required. Account balance for the developer. Use the following structure in
@@ -3915,13 +3951,16 @@ module Google
         #   REQUIRED: The resource for which the policy is being requested. See the
         #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
-        #   3. Requests specifying an invalid value will be rejected. Requests for
-        #   policies with any conditional bindings must specify version 3. Policies
-        #   without any conditional bindings may specify any valid value or leave the
-        #   field unset. To learn which resources support conditions in their IAM policies,
-        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        #   resource-policies).
+        #   Optional. The maximum policy version that will be used to format the policy.
+        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   rejected. Requests for policies with any conditional role bindings must
+        #   specify version 3. Policies with no conditional role bindings may specify any
+        #   valid value or leave the field unset. The policy in the response might use the
+        #   policy version that you specified, or it might use a lower policy version. For
+        #   example, if you specify version 3, but the policy has no conditional role
+        #   bindings, the response uses version 1. To learn which resources support
+        #   conditions in their IAM policies, see the [IAM documentation](https://cloud.
+        #   google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -5685,58 +5724,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.
+        # Similar to GetStats 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`/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`
+        #   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 +6500,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 +7106,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 +7924,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.29.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-27 00:00:00.000000000 Z
+date: 2021-12-13 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.29.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-apigee_v1
 post_install_message: 
 rdoc_options: []