google-cloud-monitoring 0.25.0 → 0.26.0

data/lib/google/cloud/monitoring/v3/doc/google/api/distribution.rb

@@ -41,7 +41,7 @@ module Google
     #     The sum of squared deviations from the mean of the values in the
     #     population.  For values x_i this is:
     #
-    #         Sum{i=1..n}[https://cloud.google.com(x_i - mean]^2)
+    #         Sum[i=1..n](https://cloud.google.com(x_i - mean)^2)
     #
     #     Knuth, "The Art of Computer Programming", Vol. 2, page 323, 3rd edition
     #     describes Welford's method for accumulating this sum in one pass.

data/lib/google/cloud/monitoring/v3/doc/google/api/metric.rb

@@ -24,13 +24,13 @@ module Google
     #     that defines the scope of the metric type or of its data; and (2) the
     #     metric's URL-encoded type, which also appears in the +type+ field of this
     #     descriptor. For example, following is the resource name of a custom
-    #     metric within the GCP project 123456789:
+    #     metric within the GCP project +my-project-id+:
     #
-    #         "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
+    #         "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
     # @!attribute [rw] type
     #   @return [String]
     #     The metric type, including its DNS name prefix. The type is not
-    #     URL-encoded.  All user-defined metric types have the DNS name
+    #     URL-encoded.  All user-defined custom metric types have the DNS name
     #     +custom.googleapis.com+.  Metric types should use a natural hierarchical
     #     grouping. For example:
     #
@@ -56,8 +56,8 @@ module Google
     #   @return [String]
     #     The unit in which the metric value is reported. It is only applicable
     #     if the +value_type+ is +INT64+, +DOUBLE+, or +DISTRIBUTION+. The
-    #     supported units are a subset of {The Unified Code for Units of
-    #     Measure}[http://unitsofmeasure.org/ucum.html] standard:
+    #     supported units are a subset of [The Unified Code for Units of
+    #     Measure](http://unitsofmeasure.org/ucum.html) standard:
     #
     #     **Basic units (UNIT)**
     #
@@ -114,10 +114,10 @@ module Google
     #     Notes:
     #
     #     * +Annotation+ is just a comment if it follows a +UNIT+ and is
-    #        equivalent to +1+ if it is used alone. For examples,
-    #        +{requests}/s == 1/s+, +By{transmitted}/s == By/s+.
+    #       equivalent to +1+ if it is used alone. For examples,
+    #       +{requests}/s == 1/s+, +By{transmitted}/s == By/s+.
     #     * +NAME+ is a sequence of non-blank printable ASCII characters not
-    #        containing '{' or '}'.
+    #       containing '{' or '}'.
     # @!attribute [rw] description
     #   @return [String]
     #     A detailed description of the metric, which can be used in documentation.
@@ -164,7 +164,7 @@ module Google
         # This value type can be used only if the metric kind is +GAUGE+.
         STRING = 4
 
-        # The value is a +Distribution+.
+        # The value is a {Google::Api::Distribution +Distribution+}.
         DISTRIBUTION = 5
 
         # The value is money.
@@ -173,10 +173,10 @@ module Google
     end
 
     # A specific metric, identified by specifying values for all of the
-    # labels of a +MetricDescriptor+.
+    # labels of a {Google::Api::MetricDescriptor +MetricDescriptor+}.
     # @!attribute [rw] type
     #   @return [String]
-    #     An existing metric type, see Google::Api::MetricDescriptor.
+    #     An existing metric type, see {Google::Api::MetricDescriptor}.
     #     For example, +custom.googleapis.com/invoice/paid/amount+.
     # @!attribute [rw] labels
     #   @return [Hash{String => String}]

data/lib/google/cloud/monitoring/v3/doc/google/api/monitored_resource.rb

@@ -14,7 +14,7 @@
 
 module Google
   module Api
-    # An object that describes the schema of a MonitoredResource object using a
+    # An object that describes the schema of a {Google::Api::MonitoredResource MonitoredResource} object using a
     # type name and a set of labels.  For example, the monitored resource
     # descriptor for Google Compute Engine VM instances has a type of
     # +"gce_instance"+ and specifies the use of the labels +"instance_id"+ and
@@ -56,11 +56,11 @@ module Google
     # An object representing a resource that can be used for monitoring, logging,
     # billing, or other purposes. Examples include virtual machine instances,
     # databases, and storage devices such as disks. The +type+ field identifies a
-    # MonitoredResourceDescriptor object that describes the resource's
+    # {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object that describes the resource's
     # schema. Information in the +labels+ field identifies the actual resource and
     # its attributes according to the schema. For example, a particular Compute
     # Engine VM instance could be represented by the following object, because the
-    # MonitoredResourceDescriptor for +"gce_instance"+ has labels
+    # {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} for +"gce_instance"+ has labels
     # +"instance_id"+ and +"zone"+:
     #
     #     { "type": "gce_instance",
@@ -69,7 +69,7 @@ module Google
     # @!attribute [rw] type
     #   @return [String]
     #     Required. The monitored resource type. This field must match
-    #     the +type+ field of a MonitoredResourceDescriptor object. For
+    #     the +type+ field of a {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
     #     example, the type of a Cloud SQL database is +"cloudsql_database"+.
     # @!attribute [rw] labels
     #   @return [Hash{String => String}]

data/lib/google/cloud/monitoring/v3/doc/google/monitoring/v3/common.rb

@@ -52,10 +52,10 @@ module Google
       # the data.  Aggregation consists of an alignment step on individual time
       # series (+per_series_aligner+) followed by an optional reduction of the data
       # across different time series (+cross_series_reducer+).  For more details, see
-      # {Aggregation}[https://cloud.google.com/monitoring/api/learn_more#aggregation].
+      # [Aggregation](https://cloud.google.com/monitoring/api/learn_more#aggregation).
       # @!attribute [rw] alignment_period
       #   @return [Google::Protobuf::Duration]
-      #     The alignment period for per-Time series
+      #     The alignment period for per-{Google::Monitoring::V3::TimeSeries time series}
       #     alignment. If present, +alignmentPeriod+ must be at least 60
       #     seconds.  After per-time series alignment, each time series will
       #     contain data points only on the period boundaries. If
@@ -124,7 +124,7 @@ module Google
           # Align and convert to a rate. This alignment is valid for
           # cumulative metrics and delta metrics with numeric values. The output is a
           # gauge metric with value type
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_RATE = 2
 
           # Align by interpolating between adjacent points around the
@@ -157,14 +157,14 @@ module Google
           # the alignment period is the average or arithmetic mean of all
           # data points in the period. This alignment is valid for gauge and delta
           # metrics with numeric values. The value type of the output is
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_MEAN = 12
 
           # Align time series via aggregation. The resulting data point in
           # the alignment period is the count of all data points in the
           # period. This alignment is valid for gauge and delta metrics with numeric
           # or Boolean values. The value type of the output is
-          # INT64.
+          # {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
           ALIGN_COUNT = 13
 
           # Align time series via aggregation. The resulting data point in
@@ -178,49 +178,49 @@ module Google
           # the alignment period is the standard deviation of all data
           # points in the period. This alignment is valid for gauge and delta metrics
           # with numeric values. The value type of the output is
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_STDDEV = 15
 
           # Align time series via aggregation. The resulting data point in
           # the alignment period is the count of True-valued data points in the
           # period. This alignment is valid for gauge metrics with
           # Boolean values. The value type of the output is
-          # INT64.
+          # {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
           ALIGN_COUNT_TRUE = 16
 
           # Align time series via aggregation. The resulting data point in
           # the alignment period is the fraction of True-valued data points in the
           # period. This alignment is valid for gauge metrics with Boolean values.
           # The output value is in the range [0, 1] and has value type
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_FRACTION_TRUE = 17
 
           # Align time series via aggregation. The resulting data point in
           # the alignment period is the 99th percentile of all data
           # points in the period. This alignment is valid for gauge and delta metrics
           # with distribution values. The output is a gauge metric with value type
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_PERCENTILE_99 = 18
 
           # Align time series via aggregation. The resulting data point in
           # the alignment period is the 95th percentile of all data
           # points in the period. This alignment is valid for gauge and delta metrics
           # with distribution values. The output is a gauge metric with value type
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_PERCENTILE_95 = 19
 
           # Align time series via aggregation. The resulting data point in
           # the alignment period is the 50th percentile of all data
           # points in the period. This alignment is valid for gauge and delta metrics
           # with distribution values. The output is a gauge metric with value type
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_PERCENTILE_50 = 20
 
           # Align time series via aggregation. The resulting data point in
           # the alignment period is the 5th percentile of all data
           # points in the period. This alignment is valid for gauge and delta metrics
           # with distribution values. The output is a gauge metric with value type
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           ALIGN_PERCENTILE_05 = 21
         end
 
@@ -234,7 +234,7 @@ module Google
           # Reduce by computing the mean across time series for each
           # alignment period. This reducer is valid for delta and
           # gauge metrics with numeric or distribution values. The value type of the
-          # output is DOUBLE.
+          # output is {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           REDUCE_MEAN = 1
 
           # Reduce by computing the minimum across time series for each
@@ -258,51 +258,51 @@ module Google
           # Reduce by computing the standard deviation across time series
           # for each alignment period. This reducer is valid for delta
           # and gauge metrics with numeric or distribution values. The value type of
-          # the output is DOUBLE.
+          # the output is {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           REDUCE_STDDEV = 5
 
           # Reduce by computing the count of data points across time series
           # for each alignment period. This reducer is valid for delta
           # and gauge metrics of numeric, Boolean, distribution, and string value
           # type. The value type of the output is
-          # INT64.
+          # {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
           REDUCE_COUNT = 6
 
           # Reduce by computing the count of True-valued data points across time
           # series for each alignment period. This reducer is valid for delta
           # and gauge metrics of Boolean value type. The value type of
-          # the output is INT64.
+          # the output is {Google::Api::MetricDescriptor::ValueType::INT64 INT64}.
           REDUCE_COUNT_TRUE = 7
 
           # Reduce by computing the fraction of True-valued data points across time
           # series for each alignment period. This reducer is valid for delta
           # and gauge metrics of Boolean value type. The output value is in the
           # range [0, 1] and has value type
-          # DOUBLE.
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}.
           REDUCE_FRACTION_TRUE = 8
 
           # Reduce by computing 99th percentile of data points across time series
           # for each alignment period. This reducer is valid for gauge and delta
           # metrics of numeric and distribution type. The value of the output is
-          # DOUBLE
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
           REDUCE_PERCENTILE_99 = 9
 
           # Reduce by computing 95th percentile of data points across time series
           # for each alignment period. This reducer is valid for gauge and delta
           # metrics of numeric and distribution type. The value of the output is
-          # DOUBLE
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
           REDUCE_PERCENTILE_95 = 10
 
           # Reduce by computing 50th percentile of data points across time series
           # for each alignment period. This reducer is valid for gauge and delta
           # metrics of numeric and distribution type. The value of the output is
-          # DOUBLE
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
           REDUCE_PERCENTILE_50 = 11
 
           # Reduce by computing 5th percentile of data points across time series
           # for each alignment period. This reducer is valid for gauge and delta
           # metrics of numeric and distribution type. The value of the output is
-          # DOUBLE
+          # {Google::Api::MetricDescriptor::ValueType::DOUBLE DOUBLE}
           REDUCE_PERCENTILE_05 = 12
         end
       end

data/lib/google/cloud/monitoring/v3/doc/google/protobuf/duration.rb

@@ -21,6 +21,8 @@ module Google
     # two Timestamp values is a Duration and it can be added or subtracted
     # from a Timestamp. Range is approximately +-10,000 years.
     #
+    # = Examples
+    #
     # Example 1: Compute Duration from two Timestamps in pseudo code.
     #
     #     Timestamp start = ...;
@@ -60,10 +62,21 @@ module Google
     #     td = datetime.timedelta(days=3, minutes=10)
     #     duration = Duration()
     #     duration.FromTimedelta(td)
+    #
+    # = JSON Mapping
+    #
+    # In JSON format, the Duration type is encoded as a string rather than an
+    # object, where the string ends in the suffix "s" (indicating seconds) and
+    # is preceded by the number of seconds, with nanoseconds expressed as
+    # fractional seconds. For example, 3 seconds with 0 nanoseconds should be
+    # encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
+    # be expressed in JSON format as "3.000000001s", and 3 seconds and 1
+    # microsecond should be expressed in JSON format as "3.000001s".
     # @!attribute [rw] seconds
     #   @return [Integer]
     #     Signed seconds of the span of time. Must be from -315,576,000,000
-    #     to +315,576,000,000 inclusive.
+    #     to +315,576,000,000 inclusive. Note: these bounds are computed from:
+    #     60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
     # @!attribute [rw] nanos
     #   @return [Integer]
     #     Signed fractions of a second at nanosecond resolution of the span

data/lib/google/cloud/monitoring/v3/doc/google/protobuf/timestamp.rb

@@ -24,7 +24,9 @@ module Google
     # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
     # By restricting to that range, we ensure that we can convert to
     # and from  RFC 3339 date strings.
-    # See {https://www.ietf.org/rfc/rfc3339.txt}[https://www.ietf.org/rfc/rfc3339.txt].
+    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    #
+    # = Examples
     #
     # Example 1: Compute Timestamp from POSIX +time()+.
     #
@@ -65,6 +67,29 @@ module Google
     #
     #     timestamp = Timestamp()
     #     timestamp.GetCurrentTime()
+    #
+    # = JSON Mapping
+    #
+    # In JSON format, the Timestamp type is encoded as a string in the
+    # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
+    # format is "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z"
+    # where {year} is always expressed using four digits while {month}, {day},
+    # {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional
+    # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
+    # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
+    # is required, though only UTC (as indicated by "Z") is presently supported.
+    #
+    # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
+    # 01:30 UTC on January 15, 2017.
+    #
+    # In JavaScript, one can convert a Date object to this format using the
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # method. In Python, a standard +datetime.datetime+ object can be converted
+    # to this format using [+strftime+](https://docs.python.org/2/library/time.html#time.strftime)
+    # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
+    # can use the Joda Time's [+ISODateTimeFormat.dateTime()+](
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime())
+    # to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]
     #     Represents seconds of UTC time since Unix epoch

data/lib/google/cloud/monitoring/v3/doc/overview.rb

@@ -0,0 +1,77 @@
+# Copyright 2017, Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Google
+  module Cloud
+    # rubocop:disable LineLength
+
+    ##
+    # # Ruby Client for Stackdriver Monitoring API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+    #
+    # [Stackdriver Monitoring API][Product Documentation]:
+    # Manages your Stackdriver Monitoring data and configurations. Most projects must
+    # be associated with a Stackdriver account, with a few exceptions as noted on the
+    # individual method pages.
+    # - [Product Documentation][]
+    #
+    # ## Quick Start
+    # In order to use this library, you first need to go through the following
+    # steps:
+    #
+    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+    # 2. [Enable the Stackdriver Monitoring API.](https://console.cloud.google.com/apis/api/monitoring)
+    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+    #
+    # ### Installation
+    # ```
+    # $ gem install google-cloud-monitoring
+    # ```
+    #
+    # ### Preview
+    # #### MetricServiceClient
+    # ```rb
+    # require "google/cloud/monitoring"
+    #
+    # metric_service_client = Google::Cloud::Monitoring::Metric.new
+    # formatted_name = Google::Cloud::Monitoring::V3::MetricServiceClient.project_path(project_id)
+    #
+    # # Iterate over all results.
+    # metric_service_client.list_monitored_resource_descriptors(formatted_name).each do |element|
+    #   # Process element.
+    # end
+    #
+    # # Or iterate over results one page at a time.
+    # metric_service_client.list_monitored_resource_descriptors(formatted_name).each_page do |page|
+    #   # Process each page at a time.
+    #   page.each do |element|
+    #     # Process element.
+    #   end
+    # end
+    # ```
+    #
+    # ### Next Steps
+    # - Read the [Stackdriver Monitoring API Product documentation][Product Documentation]
+    #   to learn more about the product and see How-to Guides.
+    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+    #   to see the full list of Cloud APIs that we cover.
+    #
+    # [Product Documentation]: https://cloud.google.com/monitoring
+    #
+    #
+    module Monitoring
+      module V3
+      end
+    end
+  end
+end

data/lib/google/cloud/monitoring/v3/group_service_client.rb

@@ -28,13 +28,14 @@ require "pathname"
 require "google/gax"
 
 require "google/monitoring/v3/group_service_pb"
+require "google/cloud/monitoring/credentials"
 
 module Google
   module Cloud
     module Monitoring
       module V3
         # The Group API lets you inspect and manage your
-        # {groups}[https://cloud.google.comgoogle.monitoring.v3.Group].
+        # [groups](https://cloud.google.comgoogle.monitoring.v3.Group).
         #
         # A group is a named filter that is used to identify
         # a collection of monitored resources. Groups are typically used to
@@ -113,36 +114,24 @@ module Google
             )
           end
 
-          # Parses the project from a project resource.
-          # @param project_name [String]
-          # @return [String]
-          def self.match_project_from_project_name project_name
-            PROJECT_PATH_TEMPLATE.match(project_name)["project"]
-          end
-
-          # Parses the project from a group resource.
-          # @param group_name [String]
-          # @return [String]
-          def self.match_project_from_group_name group_name
-            GROUP_PATH_TEMPLATE.match(group_name)["project"]
-          end
-
-          # Parses the group from a group resource.
-          # @param group_name [String]
-          # @return [String]
-          def self.match_group_from_group_name group_name
-            GROUP_PATH_TEMPLATE.match(group_name)["group"]
-          end
-
-          # @param service_path [String]
-          #   The domain name of the API remote host.
-          # @param port [Integer]
-          #   The port on which to connect to the remote host.
-          # @param channel [Channel]
-          #   A Channel object through which to make calls.
-          # @param chan_creds [Grpc::ChannelCredentials]
-          #   A ChannelCredentials for the setting up the RPC client.
-          # @param client_config[Hash]
+          # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+          #   Provides the means for authenticating requests made by the client. This parameter can
+          #   be many types.
+          #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+          #   authenticating requests made by this client.
+          #   A `String` will be treated as the path to the keyfile to be used for the construction of
+          #   credentials for this client.
+          #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+          #   credentials for this client.
+          #   A `GRPC::Core::Channel` will be used to make calls through.
+          #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+          #   should already be composed with a `GRPC::Core::CallCredentials` object.
+          #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+          #   metadata for requests, generally, to give OAuth credentials.
+          # @param scopes [Array<String>]
+          #   The OAuth scopes for this service. This parameter is ignored if
+          #   an updater_proc is supplied.
+          # @param client_config [Hash]
           #   A Hash for call options for each method. See
           #   Google::Gax#construct_settings for the structure of
           #   this data. Falls back to the default config if not specified
@@ -154,11 +143,11 @@ module Google
               port: DEFAULT_SERVICE_PORT,
               channel: nil,
               chan_creds: nil,
+              updater_proc: nil,
+              credentials: nil,
               scopes: ALL_SCOPES,
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
-              app_name: nil,
-              app_version: nil,
               lib_name: nil,
               lib_version: ""
             # These require statements are intentionally placed here to initialize
@@ -167,14 +156,38 @@ module Google
             require "google/gax/grpc"
             require "google/monitoring/v3/group_service_services_pb"
 
+            if channel || chan_creds || updater_proc
+              warn "The `channel`, `chan_creds`, and `updater_proc` parameters will be removed " \
+                "on 2017/09/08"
+              credentials ||= channel
+              credentials ||= chan_creds
+              credentials ||= updater_proc
+            end
+            if service_path != SERVICE_ADDRESS || port != DEFAULT_SERVICE_PORT
+              warn "`service_path` and `port` parameters are deprecated and will be removed"
+            end
+
+            credentials ||= Google::Cloud::Monitoring::Credentials.default
 
-            if app_name || app_version
-              warn "`app_name` and `app_version` are no longer being used in the request headers."
+            if credentials.is_a?(String) || credentials.is_a?(Hash)
+              updater_proc = Google::Cloud::Monitoring::Credentials.new(credentials).updater_proc
+            end
+            if credentials.is_a?(GRPC::Core::Channel)
+              channel = credentials
+            end
+            if credentials.is_a?(GRPC::Core::ChannelCredentials)
+              chan_creds = credentials
+            end
+            if credentials.is_a?(Proc)
+              updater_proc = credentials
+            end
+            if credentials.is_a?(Google::Auth::Credentials)
+              updater_proc = credentials.updater_proc
             end
 
             google_api_client = "gl-ruby/#{RUBY_VERSION}"
             google_api_client << " #{lib_name}/#{lib_version}" if lib_name
-            google_api_client << " gapic/0.6.8 gax/#{Google::Gax::VERSION}"
+            google_api_client << " gapic/0.1.0 gax/#{Google::Gax::VERSION}"
             google_api_client << " grpc/#{GRPC::VERSION}"
             google_api_client.freeze
 
@@ -199,6 +212,7 @@ module Google
               port,
               chan_creds: chan_creds,
               channel: channel,
+              updater_proc: updater_proc,
               scopes: scopes,
               &Google::Monitoring::V3::GroupService::Stub.method(:new)
             )
@@ -267,12 +281,10 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/monitoring/v3/group_service_client"
-          #
-          #   GroupServiceClient = Google::Cloud::Monitoring::V3::GroupServiceClient
+          #   require "google/cloud/monitoring/v3"
           #
-          #   group_service_client = GroupServiceClient.new
-          #   formatted_name = GroupServiceClient.project_path("[PROJECT]")
+          #   group_service_client = Google::Cloud::Monitoring::V3::Group.new
+          #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
           #   group_service_client.list_groups(formatted_name).each do |element|
@@ -294,13 +306,14 @@ module Google
               descendants_of_group: nil,
               page_size: nil,
               options: nil
-            req = Google::Monitoring::V3::ListGroupsRequest.new({
+            req = {
               name: name,
               children_of_group: children_of_group,
               ancestors_of_group: ancestors_of_group,
               descendants_of_group: descendants_of_group,
               page_size: page_size
-            }.delete_if { |_, v| v.nil? })
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::ListGroupsRequest)
             @list_groups.call(req, options)
           end
 
@@ -315,20 +328,19 @@ module Google
           # @return [Google::Monitoring::V3::Group]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/monitoring/v3/group_service_client"
+          #   require "google/cloud/monitoring/v3"
           #
-          #   GroupServiceClient = Google::Cloud::Monitoring::V3::GroupServiceClient
-          #
-          #   group_service_client = GroupServiceClient.new
-          #   formatted_name = GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
+          #   group_service_client = Google::Cloud::Monitoring::V3::Group.new
+          #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
           #   response = group_service_client.get_group(formatted_name)
 
           def get_group \
               name,
               options: nil
-            req = Google::Monitoring::V3::GetGroupRequest.new({
+            req = {
               name: name
-            }.delete_if { |_, v| v.nil? })
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::GetGroupRequest)
             @get_group.call(req, options)
           end
 
@@ -337,9 +349,11 @@ module Google
           # @param name [String]
           #   The project in which to create the group. The format is
           #   +"projects/{project_id_or_number}"+.
-          # @param group [Google::Monitoring::V3::Group]
+          # @param group [Google::Monitoring::V3::Group | Hash]
           #   A group definition. It is an error to define the +name+ field because
           #   the system assigns the name.
+          #   A hash of the same form as `Google::Monitoring::V3::Group`
+          #   can also be provided.
           # @param validate_only [true, false]
           #   If true, validate this request but do not create the group.
           # @param options [Google::Gax::CallOptions]
@@ -348,14 +362,11 @@ module Google
           # @return [Google::Monitoring::V3::Group]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/monitoring/v3/group_service_client"
-          #
-          #   Group = Google::Monitoring::V3::Group
-          #   GroupServiceClient = Google::Cloud::Monitoring::V3::GroupServiceClient
+          #   require "google/cloud/monitoring/v3"
           #
-          #   group_service_client = GroupServiceClient.new
-          #   formatted_name = GroupServiceClient.project_path("[PROJECT]")
-          #   group = Group.new
+          #   group_service_client = Google::Cloud::Monitoring::V3::Group.new
+          #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.project_path("[PROJECT]")
+          #   group = {}
           #   response = group_service_client.create_group(formatted_name, group)
 
           def create_group \
@@ -363,20 +374,23 @@ module Google
               group,
               validate_only: nil,
               options: nil
-            req = Google::Monitoring::V3::CreateGroupRequest.new({
+            req = {
               name: name,
               group: group,
               validate_only: validate_only
-            }.delete_if { |_, v| v.nil? })
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::CreateGroupRequest)
             @create_group.call(req, options)
           end
 
           # Updates an existing group.
           # You can change any group attributes except +name+.
           #
-          # @param group [Google::Monitoring::V3::Group]
+          # @param group [Google::Monitoring::V3::Group | Hash]
           #   The new definition of the group.  All fields of the existing group,
           #   excepting +name+, are replaced with the corresponding fields of this group.
+          #   A hash of the same form as `Google::Monitoring::V3::Group`
+          #   can also be provided.
           # @param validate_only [true, false]
           #   If true, validate this request but do not update the existing group.
           # @param options [Google::Gax::CallOptions]
@@ -385,23 +399,21 @@ module Google
           # @return [Google::Monitoring::V3::Group]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/monitoring/v3/group_service_client"
-          #
-          #   Group = Google::Monitoring::V3::Group
-          #   GroupServiceClient = Google::Cloud::Monitoring::V3::GroupServiceClient
+          #   require "google/cloud/monitoring/v3"
           #
-          #   group_service_client = GroupServiceClient.new
-          #   group = Group.new
+          #   group_service_client = Google::Cloud::Monitoring::V3::Group.new
+          #   group = {}
           #   response = group_service_client.update_group(group)
 
           def update_group \
               group,
               validate_only: nil,
               options: nil
-            req = Google::Monitoring::V3::UpdateGroupRequest.new({
+            req = {
               group: group,
               validate_only: validate_only
-            }.delete_if { |_, v| v.nil? })
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::UpdateGroupRequest)
             @update_group.call(req, options)
           end
 
@@ -415,20 +427,19 @@ module Google
           #   retries, etc.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/monitoring/v3/group_service_client"
+          #   require "google/cloud/monitoring/v3"
           #
-          #   GroupServiceClient = Google::Cloud::Monitoring::V3::GroupServiceClient
-          #
-          #   group_service_client = GroupServiceClient.new
-          #   formatted_name = GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
+          #   group_service_client = Google::Cloud::Monitoring::V3::Group.new
+          #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
           #   group_service_client.delete_group(formatted_name)
 
           def delete_group \
               name,
               options: nil
-            req = Google::Monitoring::V3::DeleteGroupRequest.new({
+            req = {
               name: name
-            }.delete_if { |_, v| v.nil? })
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::DeleteGroupRequest)
             @delete_group.call(req, options)
             nil
           end
@@ -445,18 +456,20 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param filter [String]
-          #   An optional {list filter}[https://cloud.google.com/monitoring/api/learn_more#filtering] describing
+          #   An optional [list filter](https://cloud.google.com/monitoring/api/learn_more#filtering) describing
           #   the members to be returned.  The filter may reference the type, labels, and
           #   metadata of monitored resources that comprise the group.
           #   For example, to return only resources representing Compute Engine VM
           #   instances, use this filter:
           #
           #       resource.type = "gce_instance"
-          # @param interval [Google::Monitoring::V3::TimeInterval]
+          # @param interval [Google::Monitoring::V3::TimeInterval | Hash]
           #   An optional time interval for which results should be returned. Only
           #   members that were part of the group during the specified interval are
           #   included in the response.  If no interval is provided then the group
           #   membership over the last minute is returned.
+          #   A hash of the same form as `Google::Monitoring::V3::TimeInterval`
+          #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -467,12 +480,10 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/monitoring/v3/group_service_client"
-          #
-          #   GroupServiceClient = Google::Cloud::Monitoring::V3::GroupServiceClient
+          #   require "google/cloud/monitoring/v3"
           #
-          #   group_service_client = GroupServiceClient.new
-          #   formatted_name = GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
+          #   group_service_client = Google::Cloud::Monitoring::V3::Group.new
+          #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
           #
           #   # Iterate over all results.
           #   group_service_client.list_group_members(formatted_name).each do |element|
@@ -493,12 +504,13 @@ module Google
               filter: nil,
               interval: nil,
               options: nil
-            req = Google::Monitoring::V3::ListGroupMembersRequest.new({
+            req = {
               name: name,
               page_size: page_size,
               filter: filter,
               interval: interval
-            }.delete_if { |_, v| v.nil? })
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::ListGroupMembersRequest)
             @list_group_members.call(req, options)
           end
         end