Re-generate library using google-cloud-clients/google-cloud-logging/synth.py (#3789)

Author: dpebot

google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigClient.java

@@ -53,8 +53,7 @@
 
 // AUTO-GENERATED DOCUMENTATION AND SERVICE
 /**
- * Service Description: Service for configuring sinks used to export log entries outside of
- * Stackdriver Logging.
+ * Service Description: Service for configuring sinks used to export log entries out of Logging.
  *
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -558,7 +557,7 @@ public final UnaryCallable<CreateSinkRequest, LogSink> createSinkCallable() {
    *     compatibility purposes: destination,filter,includeChildren At some point in the future,
    *     behavior will be removed and specifying an empty updateMask will be an error.
    *     <p>For a detailed `FieldMask` definition, see
-   *     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
+   *     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
    *     <p>Example: `updateMask=filter`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -606,7 +605,7 @@ public final LogSink updateSink(SinkName sinkName, LogSink sink, FieldMask updat
    *     compatibility purposes: destination,filter,includeChildren At some point in the future,
    *     behavior will be removed and specifying an empty updateMask will be an error.
    *     <p>For a detailed `FieldMask` definition, see
-   *     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
+   *     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
    *     <p>Example: `updateMask=filter`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */

google-cloud-logging/src/main/java/com/google/cloud/logging/v2/LoggingClient.java

@@ -274,11 +274,10 @@ public final UnaryCallable<DeleteLogRequest, Empty> deleteLogCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Writes log entries to Stackdriver Logging. This API method is the only way to send log entries
-   * to Stackdriver Logging. This method is used, directly or indirectly, by the Stackdriver Logging
-   * agent (fluentd) and all logging libraries configured to use Stackdriver Logging. A single
-   * request may contain log entries for a maximum of 1000 different resources (projects,
-   * organizations, billing accounts or folders)
+   * Writes log entries to Logging. This API method is the only way to send log entries to Logging.
+   * This method is used, directly or indirectly, by the Logging agent (fluentd) and all logging
+   * libraries configured to use Logging. A single request may contain log entries for a maximum of
+   * 1000 different resources (projects, organizations, billing accounts or folders)
    *
    * <p>Sample code:
    *
@@ -296,9 +295,13 @@ public final UnaryCallable<DeleteLogRequest, Empty> deleteLogCallable() {
    *     `entries` that do not specify a value for `log_name`:
    *     <p>"projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
    *     "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]"
-   *     <p>`[LOG_ID]` must be URL-encoded. For example, `"projects/my-project-id/logs/syslog"` or
-   *     `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`. For more
-   *     information about log names, see [LogEntry][google.logging.v2.LogEntry].
+   *     <p>`[LOG_ID]` must be URL-encoded. For example:
+   *     <p>"projects/my-project-id/logs/syslog"
+   *     "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
+   *     <p>The permission &lt;code&gt;logging.logEntries.create&lt;/code&gt; is needed on each
+   *     project, organization, billing account, or folder that is receiving new log entries,
+   *     whether the resource is specified in &lt;code&gt;logName&lt;/code&gt; or in an individual
+   *     log entry.
    * @param resource Optional. A default monitored resource object that is assigned to all log
    *     entries in `entries` that do not specify a value for `resource`. Example:
    *     <p>{ "type": "gce_instance", "labels": { "zone": "us-central1-a", "instance_id":
@@ -308,11 +311,11 @@ public final UnaryCallable<DeleteLogRequest, Empty> deleteLogCallable() {
    *     in `entries`. If a log entry already has a label with the same key as a label in this
    *     parameter, then the log entry's label is not changed. See
    *     [LogEntry][google.logging.v2.LogEntry].
-   * @param entries Required. The log entries to send to Stackdriver Logging. The order of log
-   *     entries in this list does not matter. Values supplied in this method's `log_name`,
-   *     `resource`, and `labels` fields are copied into those log entries in this list that do not
-   *     include values for their corresponding fields. For more information, see the
-   *     [LogEntry][google.logging.v2.LogEntry] type.
+   * @param entries Required. The log entries to send to Logging. The order of log entries in this
+   *     list does not matter. Values supplied in this method's `log_name`, `resource`, and `labels`
+   *     fields are copied into those log entries in this list that do not include values for their
+   *     corresponding fields. For more information, see the [LogEntry][google.logging.v2.LogEntry]
+   *     type.
    *     <p>If the `timestamp` or `insert_id` fields are missing in log entries, then this method
    *     supplies the current time or a unique identifier, respectively. The supplied values are
    *     chosen so that, among the log entries that did not supply their own values, the entries
@@ -345,11 +348,10 @@ public final WriteLogEntriesResponse writeLogEntries(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Writes log entries to Stackdriver Logging. This API method is the only way to send log entries
-   * to Stackdriver Logging. This method is used, directly or indirectly, by the Stackdriver Logging
-   * agent (fluentd) and all logging libraries configured to use Stackdriver Logging. A single
-   * request may contain log entries for a maximum of 1000 different resources (projects,
-   * organizations, billing accounts or folders)
+   * Writes log entries to Logging. This API method is the only way to send log entries to Logging.
+   * This method is used, directly or indirectly, by the Logging agent (fluentd) and all logging
+   * libraries configured to use Logging. A single request may contain log entries for a maximum of
+   * 1000 different resources (projects, organizations, billing accounts or folders)
    *
    * <p>Sample code:
    *
@@ -367,9 +369,13 @@ public final WriteLogEntriesResponse writeLogEntries(
    *     `entries` that do not specify a value for `log_name`:
    *     <p>"projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
    *     "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]"
-   *     <p>`[LOG_ID]` must be URL-encoded. For example, `"projects/my-project-id/logs/syslog"` or
-   *     `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`. For more
-   *     information about log names, see [LogEntry][google.logging.v2.LogEntry].
+   *     <p>`[LOG_ID]` must be URL-encoded. For example:
+   *     <p>"projects/my-project-id/logs/syslog"
+   *     "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
+   *     <p>The permission &lt;code&gt;logging.logEntries.create&lt;/code&gt; is needed on each
+   *     project, organization, billing account, or folder that is receiving new log entries,
+   *     whether the resource is specified in &lt;code&gt;logName&lt;/code&gt; or in an individual
+   *     log entry.
    * @param resource Optional. A default monitored resource object that is assigned to all log
    *     entries in `entries` that do not specify a value for `resource`. Example:
    *     <p>{ "type": "gce_instance", "labels": { "zone": "us-central1-a", "instance_id":
@@ -379,11 +385,11 @@ public final WriteLogEntriesResponse writeLogEntries(
    *     in `entries`. If a log entry already has a label with the same key as a label in this
    *     parameter, then the log entry's label is not changed. See
    *     [LogEntry][google.logging.v2.LogEntry].
-   * @param entries Required. The log entries to send to Stackdriver Logging. The order of log
-   *     entries in this list does not matter. Values supplied in this method's `log_name`,
-   *     `resource`, and `labels` fields are copied into those log entries in this list that do not
-   *     include values for their corresponding fields. For more information, see the
-   *     [LogEntry][google.logging.v2.LogEntry] type.
+   * @param entries Required. The log entries to send to Logging. The order of log entries in this
+   *     list does not matter. Values supplied in this method's `log_name`, `resource`, and `labels`
+   *     fields are copied into those log entries in this list that do not include values for their
+   *     corresponding fields. For more information, see the [LogEntry][google.logging.v2.LogEntry]
+   *     type.
    *     <p>If the `timestamp` or `insert_id` fields are missing in log entries, then this method
    *     supplies the current time or a unique identifier, respectively. The supplied values are
    *     chosen so that, among the log entries that did not supply their own values, the entries
@@ -416,11 +422,10 @@ public final WriteLogEntriesResponse writeLogEntries(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Writes log entries to Stackdriver Logging. This API method is the only way to send log entries
-   * to Stackdriver Logging. This method is used, directly or indirectly, by the Stackdriver Logging
-   * agent (fluentd) and all logging libraries configured to use Stackdriver Logging. A single
-   * request may contain log entries for a maximum of 1000 different resources (projects,
-   * organizations, billing accounts or folders)
+   * Writes log entries to Logging. This API method is the only way to send log entries to Logging.
+   * This method is used, directly or indirectly, by the Logging agent (fluentd) and all logging
+   * libraries configured to use Logging. A single request may contain log entries for a maximum of
+   * 1000 different resources (projects, organizations, billing accounts or folders)
    *
    * <p>Sample code:
    *
@@ -443,11 +448,10 @@ public final WriteLogEntriesResponse writeLogEntries(WriteLogEntriesRequest requ
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Writes log entries to Stackdriver Logging. This API method is the only way to send log entries
-   * to Stackdriver Logging. This method is used, directly or indirectly, by the Stackdriver Logging
-   * agent (fluentd) and all logging libraries configured to use Stackdriver Logging. A single
-   * request may contain log entries for a maximum of 1000 different resources (projects,
-   * organizations, billing accounts or folders)
+   * Writes log entries to Logging. This API method is the only way to send log entries to Logging.
+   * This method is used, directly or indirectly, by the Logging agent (fluentd) and all logging
+   * libraries configured to use Logging. A single request may contain log entries for a maximum of
+   * 1000 different resources (projects, organizations, billing accounts or folders)
    *
    * <p>Sample code:
    *
@@ -470,8 +474,8 @@ public final WriteLogEntriesResponse writeLogEntries(WriteLogEntriesRequest requ
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways
-   * to export log entries, see [Exporting Logs](/logging/docs/export).
+   * Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log
+   * entries, see [Exporting Logs](/logging/docs/export).
    *
    * <p>Sample code:
    *
@@ -517,8 +521,8 @@ public final ListLogEntriesPagedResponse listLogEntries(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways
-   * to export log entries, see [Exporting Logs](/logging/docs/export).
+   * Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log
+   * entries, see [Exporting Logs](/logging/docs/export).
    *
    * <p>Sample code:
    *
@@ -543,8 +547,8 @@ public final ListLogEntriesPagedResponse listLogEntries(ListLogEntriesRequest re
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways
-   * to export log entries, see [Exporting Logs](/logging/docs/export).
+   * Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log
+   * entries, see [Exporting Logs](/logging/docs/export).
    *
    * <p>Sample code:
    *
@@ -569,8 +573,8 @@ public final ListLogEntriesPagedResponse listLogEntries(ListLogEntriesRequest re
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists log entries. Use this method to retrieve log entries from Stackdriver Logging. For ways
-   * to export log entries, see [Exporting Logs](/logging/docs/export).
+   * Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log
+   * entries, see [Exporting Logs](/logging/docs/export).
    *
    * <p>Sample code:
    *
@@ -602,7 +606,7 @@ public final ListLogEntriesPagedResponse listLogEntries(ListLogEntriesRequest re
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists the descriptors for monitored resource types used by Stackdriver Logging.
+   * Lists the descriptors for monitored resource types used by Logging.
    *
    * <p>Sample code:
    *
@@ -625,7 +629,7 @@ public final ListMonitoredResourceDescriptorsPagedResponse listMonitoredResource
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists the descriptors for monitored resource types used by Stackdriver Logging.
+   * Lists the descriptors for monitored resource types used by Logging.
    *
    * <p>Sample code:
    *
@@ -648,7 +652,7 @@ public final ListMonitoredResourceDescriptorsPagedResponse listMonitoredResource
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists the descriptors for monitored resource types used by Stackdriver Logging.
+   * Lists the descriptors for monitored resource types used by Logging.
    *
    * <p>Sample code:
    *

google-cloud-logging/src/main/java/com/google/cloud/logging/v2/package-info.java

@@ -36,8 +36,7 @@
  *
  * ============ ConfigClient ============
  *
- * <p>Service Description: Service for configuring sinks used to export log entries outside of
- * Stackdriver Logging.
+ * <p>Service Description: Service for configuring sinks used to export log entries out of Logging.
  *
  * <p>Sample for ConfigClient:
  *

grpc-google-cloud-logging-v2/src/main/java/com/google/logging/v2/ConfigServiceV2Grpc.java

@@ -17,8 +17,8 @@
 
 /**
  * <pre>
- * Service for configuring sinks used to export log entries outside of
- * Stackdriver Logging.
+ * Service for configuring sinks used to export log entries out of
+ * Logging.
  * </pre>
  */
 @javax.annotation.Generated(
@@ -427,8 +427,8 @@ public static ConfigServiceV2FutureStub newFutureStub(
 
   /**
    * <pre>
-   * Service for configuring sinks used to export log entries outside of
-   * Stackdriver Logging.
+   * Service for configuring sinks used to export log entries out of
+   * Logging.
    * </pre>
    */
   public static abstract class ConfigServiceV2ImplBase implements io.grpc.BindableService {
@@ -620,8 +620,8 @@ public void deleteExclusion(com.google.logging.v2.DeleteExclusionRequest request
 
   /**
    * <pre>
-   * Service for configuring sinks used to export log entries outside of
-   * Stackdriver Logging.
+   * Service for configuring sinks used to export log entries out of
+   * Logging.
    * </pre>
    */
   public static final class ConfigServiceV2Stub extends io.grpc.stub.AbstractStub<ConfigServiceV2Stub> {
@@ -762,8 +762,8 @@ public void deleteExclusion(com.google.logging.v2.DeleteExclusionRequest request
 
   /**
    * <pre>
-   * Service for configuring sinks used to export log entries outside of
-   * Stackdriver Logging.
+   * Service for configuring sinks used to export log entries out of
+   * Logging.
    * </pre>
    */
   public static final class ConfigServiceV2BlockingStub extends io.grpc.stub.AbstractStub<ConfigServiceV2BlockingStub> {
@@ -894,8 +894,8 @@ public com.google.protobuf.Empty deleteExclusion(com.google.logging.v2.DeleteExc
 
   /**
    * <pre>
-   * Service for configuring sinks used to export log entries outside of
-   * Stackdriver Logging.
+   * Service for configuring sinks used to export log entries out of
+   * Logging.
    * </pre>
    */
   public static final class ConfigServiceV2FutureStub extends io.grpc.stub.AbstractStub<ConfigServiceV2FutureStub> {