google-cloud-error_reporting-v1beta1 0.1.1 → 0.4.0

data/lib/google/cloud/error_reporting/v1beta1.rb

@@ -35,3 +35,6 @@ module Google
     end
   end
 end
+
+helper_path = ::File.join __dir__, "v1beta1", "_helpers.rb"
+require "google/cloud/error_reporting/v1beta1/_helpers" if ::File.file? helper_path

data/lib/google/cloud/error_reporting/v1beta1/error_group_service/client.rb

@@ -60,7 +60,7 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -68,9 +68,9 @@ module Google
                 default_config.timeout = 600.0
                 default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14, 4]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14, 4]
                 }
 
                 default_config
@@ -134,7 +134,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope: @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -171,7 +177,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param group_name [::String]
-            #     The group resource name. Written as
+            #     Required. The group resource name. Written as
             #     `projects/{projectID}/groups/{group_name}`. Call
             #     [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
             #     to return a list of groups belonging to this project.
@@ -375,14 +381,14 @@ module Google
 
               config_attr :endpoint,      "clouderrorreporting.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -403,7 +409,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -415,7 +421,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -439,9 +445,9 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  get_group_config = parent_rpcs&.get_group if parent_rpcs&.respond_to? :get_group
+                  get_group_config = parent_rpcs.get_group if parent_rpcs.respond_to? :get_group
                   @get_group = ::Gapic::Config::Method.new get_group_config
-                  update_group_config = parent_rpcs&.update_group if parent_rpcs&.respond_to? :update_group
+                  update_group_config = parent_rpcs.update_group if parent_rpcs.respond_to? :update_group
                   @update_group = ::Gapic::Config::Method.new update_group_config
 
                   yield self if block_given?

data/lib/google/cloud/error_reporting/v1beta1/error_stats_service/client.rb

@@ -61,7 +61,7 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -69,9 +69,9 @@ module Google
                 default_config.timeout = 600.0
                 default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14, 4]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14, 4]
                 }
 
                 default_config
@@ -135,7 +135,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope: @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -173,11 +179,11 @@ module Google
             #
             #   @param project_name [::String]
             #     Required. The resource name of the Google Cloud Platform project. Written
-            #     as <code>projects/</code> plus the
-            #     <a href="https://support.google.com/cloud/answer/6158840">Google Cloud
-            #     Platform project ID</a>.
+            #     as `projects/{projectID}` or `projects/{projectNumber}`, where `{projectID}`
+            #     and `{projectNumber}` can be found in the
+            #     [Google Cloud Console](https://support.google.com/cloud/answer/6158840).
             #
-            #     Example: <code>projects/my-project-123</code>.
+            #     Examples: `projects/my-project-123`, `projects/5551234`.
             #   @param group_id [::Array<::String>]
             #     Optional. List all <code>ErrorGroupStats</code> with these IDs.
             #   @param service_filter [::Google::Cloud::ErrorReporting::V1beta1::ServiceContextFilter, ::Hash]
@@ -279,9 +285,10 @@ module Google
             #
             #   @param project_name [::String]
             #     Required. The resource name of the Google Cloud Platform project. Written
-            #     as `projects/` plus the
+            #     as `projects/{projectID}`, where `{projectID}` is the
             #     [Google Cloud Platform project
             #     ID](https://support.google.com/cloud/answer/6158840).
+            #
             #     Example: `projects/my-project-123`.
             #   @param group_id [::String]
             #     Required. The group for which events shall be returned.
@@ -364,9 +371,10 @@ module Google
             #
             #   @param project_name [::String]
             #     Required. The resource name of the Google Cloud Platform project. Written
-            #     as `projects/` plus the
+            #     as `projects/{projectID}`, where `{projectID}` is the
             #     [Google Cloud Platform project
             #     ID](https://support.google.com/cloud/answer/6158840).
+            #
             #     Example: `projects/my-project-123`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -499,14 +507,14 @@ module Google
 
               config_attr :endpoint,      "clouderrorreporting.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -527,7 +535,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -539,7 +547,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -568,11 +576,11 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_group_stats_config = parent_rpcs&.list_group_stats if parent_rpcs&.respond_to? :list_group_stats
+                  list_group_stats_config = parent_rpcs.list_group_stats if parent_rpcs.respond_to? :list_group_stats
                   @list_group_stats = ::Gapic::Config::Method.new list_group_stats_config
-                  list_events_config = parent_rpcs&.list_events if parent_rpcs&.respond_to? :list_events
+                  list_events_config = parent_rpcs.list_events if parent_rpcs.respond_to? :list_events
                   @list_events = ::Gapic::Config::Method.new list_events_config
-                  delete_events_config = parent_rpcs&.delete_events if parent_rpcs&.respond_to? :delete_events
+                  delete_events_config = parent_rpcs.delete_events if parent_rpcs.respond_to? :delete_events
                   @delete_events = ::Gapic::Config::Method.new delete_events_config
 
                   yield self if block_given?

data/lib/google/cloud/error_reporting/v1beta1/report_errors_service/client.rb

@@ -60,7 +60,7 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -128,7 +128,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope: @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -147,7 +153,7 @@ module Google
             # Service calls
 
             ##
-            # Report an individual error event.
+            # Report an individual error event and record the event to a log.
             #
             # This endpoint accepts **either** an OAuth token,
             # **or** an [API key](https://support.google.com/cloud/answer/6158862)
@@ -155,7 +161,15 @@ module Google
             # a `key` parameter. For example:
             #
             # `POST
-            # https://clouderrorreporting.googleapis.com/v1beta1/projects/example-project/events:report?key=123ABC456`
+            # https://clouderrorreporting.googleapis.com/v1beta1/\\{projectName}/events:report?key=123ABC456`
+            #
+            # **Note:** [Error Reporting](/error-reporting) is a global service built
+            # on Cloud Logging and doesn't analyze logs stored
+            # in regional log buckets or logs routed to other Google Cloud projects.
+            #
+            # For more information, see
+            # [Using Error Reporting with regionalized
+            # logs](/error-reporting/docs/regionalization).
             #
             # @overload report_error_event(request, options = nil)
             #   Pass arguments to `report_error_event` via a request object, either of type
@@ -174,10 +188,11 @@ module Google
             #
             #   @param project_name [::String]
             #     Required. The resource name of the Google Cloud Platform project. Written
-            #     as `projects/` plus the
+            #     as `projects/{projectId}`, where `{projectId}` is the
             #     [Google Cloud Platform project
-            #     ID](https://support.google.com/cloud/answer/6158840). Example:
-            #     `projects/my-project-123`.
+            #     ID](https://support.google.com/cloud/answer/6158840).
+            #
+            #     Example: // `projects/my-project-123`.
             #   @param event [::Google::Cloud::ErrorReporting::V1beta1::ReportedErrorEvent, ::Hash]
             #     Required. The error event to be reported.
             #
@@ -311,14 +326,14 @@ module Google
 
               config_attr :endpoint,      "clouderrorreporting.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -339,7 +354,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -351,7 +366,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -370,7 +385,7 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  report_error_event_config = parent_rpcs&.report_error_event if parent_rpcs&.respond_to? :report_error_event
+                  report_error_event_config = parent_rpcs.report_error_event if parent_rpcs.respond_to? :report_error_event
                   @report_error_event = ::Gapic::Config::Method.new report_error_event_config
 
                   yield self if block_given?

data/lib/google/cloud/error_reporting/v1beta1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ErrorReporting
       module V1beta1
-        VERSION = "0.1.1"
+        VERSION = "0.4.0"
       end
     end
   end

data/lib/google/devtools/clouderrorreporting/v1beta1/common_pb.rb

@@ -3,15 +3,16 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/resource_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/devtools/clouderrorreporting/v1beta1/common.proto", :syntax => :proto3) do
     add_message "google.devtools.clouderrorreporting.v1beta1.ErrorGroup" do
       optional :name, :string, 1
       optional :group_id, :string, 2
       repeated :tracking_issues, :message, 3, "google.devtools.clouderrorreporting.v1beta1.TrackingIssue"
+      optional :resolution_status, :enum, 5, "google.devtools.clouderrorreporting.v1beta1.ResolutionStatus"
     end
     add_message "google.devtools.clouderrorreporting.v1beta1.TrackingIssue" do
       optional :url, :string, 1
@@ -45,6 +46,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :line_number, :int32, 2
       optional :function_name, :string, 4
     end
+    add_enum "google.devtools.clouderrorreporting.v1beta1.ResolutionStatus" do
+      value :RESOLUTION_STATUS_UNSPECIFIED, 0
+      value :OPEN, 1
+      value :ACKNOWLEDGED, 2
+      value :RESOLVED, 3
+      value :MUTED, 4
+    end
   end
 end
 
@@ -59,6 +67,7 @@ module Google
         ErrorContext = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.clouderrorreporting.v1beta1.ErrorContext").msgclass
         HttpRequestContext = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.clouderrorreporting.v1beta1.HttpRequestContext").msgclass
         SourceLocation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.clouderrorreporting.v1beta1.SourceLocation").msgclass
+        ResolutionStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.clouderrorreporting.v1beta1.ResolutionStatus").enummodule
       end
     end
   end

data/lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/devtools/clouderrorreporting/v1beta1/error_group_service.proto for package 'Google.Cloud.ErrorReporting.V1beta1'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2021 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,7 +15,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-#
 
 require 'grpc'
 require 'google/devtools/clouderrorreporting/v1beta1/error_group_service_pb'
@@ -35,10 +34,10 @@ module Google
             self.service_name = 'google.devtools.clouderrorreporting.v1beta1.ErrorGroupService'
 
             # Get the specified group.
-            rpc :GetGroup, Google::Cloud::ErrorReporting::V1beta1::GetGroupRequest, Google::Cloud::ErrorReporting::V1beta1::ErrorGroup
+            rpc :GetGroup, ::Google::Cloud::ErrorReporting::V1beta1::GetGroupRequest, ::Google::Cloud::ErrorReporting::V1beta1::ErrorGroup
             # Replace the data for the specified group.
             # Fails if the group does not exist.
-            rpc :UpdateGroup, Google::Cloud::ErrorReporting::V1beta1::UpdateGroupRequest, Google::Cloud::ErrorReporting::V1beta1::ErrorGroup
+            rpc :UpdateGroup, ::Google::Cloud::ErrorReporting::V1beta1::UpdateGroupRequest, ::Google::Cloud::ErrorReporting::V1beta1::ErrorGroup
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/devtools/clouderrorreporting/v1beta1/error_stats_service.proto for package 'Google.Cloud.ErrorReporting.V1beta1'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2021 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,7 +15,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-#
 
 require 'grpc'
 require 'google/devtools/clouderrorreporting/v1beta1/error_stats_service_pb'
@@ -36,11 +35,11 @@ module Google
             self.service_name = 'google.devtools.clouderrorreporting.v1beta1.ErrorStatsService'
 
             # Lists the specified groups.
-            rpc :ListGroupStats, Google::Cloud::ErrorReporting::V1beta1::ListGroupStatsRequest, Google::Cloud::ErrorReporting::V1beta1::ListGroupStatsResponse
+            rpc :ListGroupStats, ::Google::Cloud::ErrorReporting::V1beta1::ListGroupStatsRequest, ::Google::Cloud::ErrorReporting::V1beta1::ListGroupStatsResponse
             # Lists the specified events.
-            rpc :ListEvents, Google::Cloud::ErrorReporting::V1beta1::ListEventsRequest, Google::Cloud::ErrorReporting::V1beta1::ListEventsResponse
+            rpc :ListEvents, ::Google::Cloud::ErrorReporting::V1beta1::ListEventsRequest, ::Google::Cloud::ErrorReporting::V1beta1::ListEventsResponse
             # Deletes all error events of a given project.
-            rpc :DeleteEvents, Google::Cloud::ErrorReporting::V1beta1::DeleteEventsRequest, Google::Cloud::ErrorReporting::V1beta1::DeleteEventsResponse
+            rpc :DeleteEvents, ::Google::Cloud::ErrorReporting::V1beta1::DeleteEventsRequest, ::Google::Cloud::ErrorReporting::V1beta1::DeleteEventsResponse
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/devtools/clouderrorreporting/v1beta1/report_errors_service.proto for package 'Google.Cloud.ErrorReporting.V1beta1'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2021 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,7 +15,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-#
 
 require 'grpc'
 require 'google/devtools/clouderrorreporting/v1beta1/report_errors_service_pb'
@@ -34,7 +33,7 @@ module Google
             self.unmarshal_class_method = :decode
             self.service_name = 'google.devtools.clouderrorreporting.v1beta1.ReportErrorsService'
 
-            # Report an individual error event.
+            # Report an individual error event and record the event to a log.
             #
             # This endpoint accepts **either** an OAuth token,
             # **or** an [API key](https://support.google.com/cloud/answer/6158862)
@@ -42,8 +41,16 @@ module Google
             # a `key` parameter. For example:
             #
             # `POST
-            # https://clouderrorreporting.googleapis.com/v1beta1/projects/example-project/events:report?key=123ABC456`
-            rpc :ReportErrorEvent, Google::Cloud::ErrorReporting::V1beta1::ReportErrorEventRequest, Google::Cloud::ErrorReporting::V1beta1::ReportErrorEventResponse
+            # https://clouderrorreporting.googleapis.com/v1beta1/{projectName}/events:report?key=123ABC456`
+            #
+            # **Note:** [Error Reporting](/error-reporting) is a global service built
+            # on Cloud Logging and doesn't analyze logs stored
+            # in regional log buckets or logs routed to other Google Cloud projects.
+            #
+            # For more information, see
+            # [Using Error Reporting with regionalized
+            # logs](/error-reporting/docs/regionalization).
+            rpc :ReportErrorEvent, ::Google::Cloud::ErrorReporting::V1beta1::ReportErrorEventRequest, ::Google::Cloud::ErrorReporting::V1beta1::ReportErrorEventResponse
           end
 
           Stub = Service.rpc_stub_class