googleapis · daniel-sanche · Mar 31, 2021 · Mar 6, 2021 · Mar 6, 2021 · Mar 6, 2021
diff --git a/.coveragerc b/.coveragerc
@@ -1,27 +1,11 @@
-# -*- coding: utf-8 -*-
-#
-# Copyright 2020 Google LLC
-#
-# 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
-#
-#     https://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.
-
-# Generated by synthtool. DO NOT EDIT!
 [run]
 branch = True
 
 [report]
 fail_under = 100
 show_missing = True
-omit = google/cloud/errorreporting/__init__.py, .nox/*
+omit =
+    google/cloud/errorreporting/__init__.py
 exclude_lines =
     # Re-enable the standard pragma
     pragma: NO COVER
@@ -31,4 +15,4 @@ exclude_lines =
     # This is added at the module level as a safeguard for if someone
     # generates the code and tries to run it without pip installing. This
     # makes it virtually impossible to test properly.
-    except pkg_resources.DistributionNotFound
+    except pkg_resources.DistributionNotFound
diff --git a/docs/errorreporting_v1beta1/error_group_service.rst b/docs/errorreporting_v1beta1/error_group_service.rst
@@ -0,0 +1,6 @@
+ErrorGroupService
+-----------------------------------
+
+.. automodule:: google.cloud.errorreporting_v1beta1.services.error_group_service
+    :members:
+    :inherited-members:
diff --git a/docs/errorreporting_v1beta1/error_stats_service.rst b/docs/errorreporting_v1beta1/error_stats_service.rst
@@ -0,0 +1,11 @@
+ErrorStatsService
+-----------------------------------
+
+.. automodule:: google.cloud.errorreporting_v1beta1.services.error_stats_service
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.errorreporting_v1beta1.services.error_stats_service.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/errorreporting_v1beta1/report_errors_service.rst b/docs/errorreporting_v1beta1/report_errors_service.rst
@@ -0,0 +1,6 @@
+ReportErrorsService
+-------------------------------------
+
+.. automodule:: google.cloud.errorreporting_v1beta1.services.report_errors_service
+    :members:
+    :inherited-members:
diff --git a/docs/errorreporting_v1beta1/services.rst b/docs/errorreporting_v1beta1/services.rst
@@ -1,12 +1,8 @@
 Services for Google Cloud Errorreporting v1beta1 API
 ====================================================
+.. toctree::
+    :maxdepth: 2
 
-.. automodule:: google.cloud.errorreporting_v1beta1.services.error_group_service
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.errorreporting_v1beta1.services.error_stats_service
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.errorreporting_v1beta1.services.report_errors_service
-    :members:
-    :inherited-members:
+    error_group_service
+    error_stats_service
+    report_errors_service
diff --git a/docs/errorreporting_v1beta1/types.rst b/docs/errorreporting_v1beta1/types.rst
@@ -3,4 +3,5 @@ Types for Google Cloud Errorreporting v1beta1 API
 
 .. automodule:: google.cloud.errorreporting_v1beta1.types
     :members:
+    :undoc-members:
     :show-inheritance:
diff --git a/google/cloud/errorreporting_v1beta1/__init__.py b/google/cloud/errorreporting_v1beta1/__init__.py
@@ -22,6 +22,7 @@
 from .types.common import ErrorEvent
 from .types.common import ErrorGroup
 from .types.common import HttpRequestContext
+from .types.common import ResolutionStatus
 from .types.common import ServiceContext
 from .types.common import SourceLocation
 from .types.common import TrackingIssue
@@ -51,6 +52,7 @@
     "ErrorEvent",
     "ErrorGroup",
     "ErrorGroupOrder",
+    "ErrorGroupServiceClient",
     "ErrorGroupStats",
     "ErrorStatsServiceClient",
     "GetGroupRequest",
@@ -62,14 +64,14 @@
     "QueryTimeRange",
     "ReportErrorEventRequest",
     "ReportErrorEventResponse",
-    "ReportErrorsServiceClient",
     "ReportedErrorEvent",
+    "ResolutionStatus",
     "ServiceContext",
     "ServiceContextFilter",
     "SourceLocation",
     "TimedCount",
     "TimedCountAlignment",
     "TrackingIssue",
     "UpdateGroupRequest",
-    "ErrorGroupServiceClient",
+    "ReportErrorsServiceClient",
 )
diff --git a/google/cloud/errorreporting_v1beta1/proto/common.proto b/google/cloud/errorreporting_v1beta1/proto/common.proto
@@ -1,4 +1,4 @@
-// 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.
@@ -16,9 +16,9 @@ syntax = "proto3";
 
 package google.devtools.clouderrorreporting.v1beta1;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
@@ -37,7 +37,7 @@ message ErrorGroup {
   };
 
   // The group resource name.
-  // Example: <code>projects/my-project-123/groups/my-groupid</code>
+  // Example: <code>projects/my-project-123/groups/CNSgkpnppqKCUw</code>
   string name = 1;
 
   // Group IDs are unique for a given project. If the same kind of error
@@ -46,6 +46,10 @@ message ErrorGroup {
 
   // Associated tracking issues.
   repeated TrackingIssue tracking_issues = 3;
+
+  // Error group's resolution status.
+  // An unspecified resolution status will be interpreted as OPEN
+  ResolutionStatus resolution_status = 5;
 }
 
 // Information related to tracking the progress on resolving the error.
@@ -169,3 +173,24 @@ message SourceLocation {
   // For example, `my.package.MyClass.method` in case of Java.
   string function_name = 4;
 }
+
+// Resolution status of an error group.
+enum ResolutionStatus {
+  // Status is unknown. When left unspecified in requests, it is treated like
+  // OPEN.
+  RESOLUTION_STATUS_UNSPECIFIED = 0;
+
+  // The error group is not being addressed. This is the default for
+  // new groups. It is also used for errors re-occurring after marked RESOLVED.
+  OPEN = 1;
+
+  // Error Group manually acknowledged, it can have an issue link attached.
+  ACKNOWLEDGED = 2;
+
+  // Error Group manually resolved, more events for this group are not expected
+  // to occur.
+  RESOLVED = 3;
+
+  // The error group is muted and excluded by default on group stats requests.
+  MUTED = 4;
+}
diff --git a/google/cloud/errorreporting_v1beta1/proto/error_group_service.proto b/google/cloud/errorreporting_v1beta1/proto/error_group_service.proto
@@ -1,4 +1,4 @@
-// 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.
@@ -11,7 +11,6 @@
 // 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.
-//
 
 syntax = "proto3";
 
@@ -58,7 +57,7 @@ service ErrorGroupService {
 
 // A request to return an individual group.
 message GetGroupRequest {
-  // 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.

diff --git a/google/cloud/errorreporting_v1beta1/proto/error_stats_service.proto b/google/cloud/errorreporting_v1beta1/proto/error_stats_service.proto
@@ -1,4 +1,4 @@
-// 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.
@@ -11,7 +11,6 @@
 // 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.
-//
 
 syntax = "proto3";
 
@@ -68,11 +67,11 @@ service ErrorStatsService {
 // Specifies a set of `ErrorGroupStats` to return.
 message ListGroupStatsRequest {
   // 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`.
   string project_name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -258,9 +257,10 @@ enum ErrorGroupOrder {
 // Specifies a set of error events to return.
 message ListEventsRequest {
   // 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`.
   string project_name = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -357,9 +357,10 @@ message ServiceContextFilter {
 // Deletes all events in the project.
 message DeleteEventsRequest {
   // 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`.
   string project_name = 1 [
     (google.api.field_behavior) = REQUIRED,

diff --git a/google/cloud/errorreporting_v1beta1/proto/report_errors_service.proto b/google/cloud/errorreporting_v1beta1/proto/report_errors_service.proto
@@ -1,4 +1,4 @@
-// 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.
@@ -11,7 +11,6 @@
 // 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.
-//
 
 syntax = "proto3";
 
@@ -38,15 +37,23 @@ service ReportErrorsService {
   option (google.api.default_host) = "clouderrorreporting.googleapis.com";
   option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
 
-  // 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)
   // for authentication. To use an API key, append it to the URL as the value of
   // 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).
   rpc ReportErrorEvent(ReportErrorEventRequest) returns (ReportErrorEventResponse) {
     option (google.api.http) = {
       post: "/v1beta1/{project_name=projects/*}/events:report"
@@ -59,10 +66,11 @@ service ReportErrorsService {
 // A request for reporting an individual error event.
 message ReportErrorEventRequest {
   // 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`.
   string project_name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {