feat: [common-protos] Log Analytics features of the Cloud Logging API (…

…#1573)

- [ ] Regenerate this pull request now.

feat: Add ConfigServiceV2.CreateBucketAsync method for creating Log Buckets asynchronously
feat: Add ConfigServiceV2.UpdateBucketAsync method for creating Log Buckets asynchronously
feat: Add ConfigServiceV2.CreateLink method for creating linked datasets for Log Analytics Buckets
feat: Add ConfigServiceV2.DeleteLink method for deleting linked datasets
feat: Add ConfigServiceV2.ListLinks method for listing linked datasets
feat: Add ConfigServiceV2.GetLink methods for describing linked datasets
feat: Add LogBucket.analytics_enabled field that specifies whether Log Bucket's Analytics features are enabled
feat: Add LogBucket.index_configs field that contains a list of Log Bucket's indexed fields and related configuration data
docs: Documentation for the Log Analytics features of the Cloud Logging API

PiperOrigin-RevId: 529851525

Source-Link: https://togithub.com/googleapis/googleapis/commit/1c7ee99d19adf8e444e2d73c5dd52884eab9862d

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/4a2a3a05b91804333a1b39b635d8fe2243d4b4fd
Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiI0YTJhM2EwNWI5MTgwNDMzM2ExYjM5YjYzNWQ4ZmUyMjQzZDRiNGZkIn0=

BEGIN_NESTED_COMMIT
feat: [common-protos] add GEO, SHOPPING, GENERATIVE_AI client orgs
docs: fix new_issue_uri comment

PiperOrigin-RevId: 527926860

Source-Link: https://togithub.com/googleapis/googleapis/commit/2f4668caa329c6dd67c14a5864076a48f0c17841

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/fa34096a242426ee1f714dc1249cd28814439e3e
Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiJmYTM0MDk2YTI0MjQyNmVlMWY3MTRkYzEyNDljZDI4ODE0NDM5ZTNlIn0=
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
docs: [common-protos] use deprecated=true for deprecated fields
PiperOrigin-RevId: 521675703

Source-Link: https://togithub.com/googleapis/googleapis/commit/8bc5a83d9759f2153f2e62d79dc2a024bcf7a3ac

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/3a4cf08318827b8ce36d2e6471ca24ae88c0900f
Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiIzYTRjZjA4MzE4ODI3YjhjZTM2ZDJlNjQ3MWNhMjRhZTg4YzA5MDBmIn0=
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
docs: [common-protos] mark ReservationResourceUsage field as deprecated
PiperOrigin-RevId: 521058593

Source-Link: https://togithub.com/googleapis/googleapis/commit/4c3b682f501bb965d34c3d4fc3461edfccf962db

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/9d3275bce3ee4c6b2f6a4529d3cff7e7cdff1ce5
Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiI5ZDMyNzViY2UzZWU0YzZiMmY2YTQ1MjlkM2NmZjdlN2NkZmYxY2U1In0=
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
chore(deps): [common-protos] Update gapic-generator-java to 2.16.0
PiperOrigin-RevId: 520153493

Source-Link: https://togithub.com/googleapis/googleapis/commit/26a424a2e4190c3103ab6f5d00c3144c89161b20

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/78f1567661df07bea7425e4341012e7b77c11254
Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiI3OGYxNTY3NjYxZGYwN2JlYTc0MjVlNDM0MTAxMmU3Yjc3YzExMjU0In0=
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
feat: [common-protos] .NET library settings (for generator behavior tweaks)
docs: separate paragraphs in linear/exponential distributions

PiperOrigin-RevId: 520041337

Source-Link: https://togithub.com/googleapis/googleapis/commit/ed78055479a002e3c8c5f1f12c2e6bed52360428

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/a0b9e45d4e9ce213972593f62924242991087209
Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiJhMGI5ZTQ1ZDRlOWNlMjEzOTcyNTkzZjYyOTI0MjQyOTkxMDg3MjA5In0=
END_NESTED_COMMIT

java-common-protos/grpc-google-common-protos/src/main/java/com/google/cloud/location/LocationsGrpc.java

@@ -171,7 +171,7 @@ public LocationsFutureStub newStub(
  * [Location.metadata][google.cloud.location.Location.metadata] field.
  * </pre>
  */
- public abstract static class LocationsImplBase implements io.grpc.BindableService {
+ public interface AsyncService {
 
  /**
  *
@@ -180,7 +180,7 @@ public abstract static class LocationsImplBase implements io.grpc.BindableServic
  * Lists information about the supported locations for this service.
  * </pre>
  */
- public void listLocations(
+ default void listLocations(
  com.google.cloud.location.ListLocationsRequest request,
  io.grpc.stub.StreamObserver<com.google.cloud.location.ListLocationsResponse>
  responseObserver) {
@@ -195,35 +195,33 @@ public void listLocations(
  * Gets information about a location.
  * </pre>
  */
- public void getLocation(
+ default void getLocation(
  com.google.cloud.location.GetLocationRequest request,
  io.grpc.stub.StreamObserver<com.google.cloud.location.Location> responseObserver) {
  io.grpc.stub.ServerCalls.asyncUnimplementedUnaryCall(
  getGetLocationMethod(), responseObserver);
  }
+ }
+
+ /**
+ * Base class for the server implementation of the service Locations.
+ *
+ * <pre>
+ * An abstract interface that provides location-related information for
+ * a service. Service-specific metadata is provided through the
+ * [Location.metadata][google.cloud.location.Location.metadata] field.
+ * </pre>
+ */
+ public abstract static class LocationsImplBase implements io.grpc.BindableService, AsyncService {
 
  @java.lang.Override
  public final io.grpc.ServerServiceDefinition bindService() {
- return io.grpc.ServerServiceDefinition.builder(getServiceDescriptor())
- .addMethod(
- getListLocationsMethod(),
- io.grpc.stub.ServerCalls.asyncUnaryCall(
- new MethodHandlers<
- com.google.cloud.location.ListLocationsRequest,
- com.google.cloud.location.ListLocationsResponse>(
- this, METHODID_LIST_LOCATIONS)))
- .addMethod(
- getGetLocationMethod(),
- io.grpc.stub.ServerCalls.asyncUnaryCall(
- new MethodHandlers<
- com.google.cloud.location.GetLocationRequest,
- com.google.cloud.location.Location>(this, METHODID_GET_LOCATION)))
- .build();
+ return LocationsGrpc.bindService(this);
  }
  }
 
  /**
- *
+ * A stub to allow clients to do asynchronous rpc calls to service Locations.
  *
  * <pre>
  * An abstract interface that provides location-related information for
@@ -276,7 +274,7 @@ public void getLocation(
  }
 
  /**
- *
+ * A stub to allow clients to do synchronous rpc calls to service Locations.
  *
  * <pre>
  * An abstract interface that provides location-related information for
@@ -324,7 +322,7 @@ public com.google.cloud.location.Location getLocation(
  }
 
  /**
- *
+ * A stub to allow clients to do ListenableFuture-style rpc calls to service Locations.
  *
  * <pre>
  * An abstract interface that provides location-related information for
@@ -379,10 +377,10 @@ private static final class MethodHandlers<Req, Resp>
  io.grpc.stub.ServerCalls.ServerStreamingMethod<Req, Resp>,
  io.grpc.stub.ServerCalls.ClientStreamingMethod<Req, Resp>,
  io.grpc.stub.ServerCalls.BidiStreamingMethod<Req, Resp> {
- private final LocationsImplBase serviceImpl;
+ private final AsyncService serviceImpl;
  private final int methodId;
 
- MethodHandlers(LocationsImplBase serviceImpl, int methodId) {
+ MethodHandlers(AsyncService serviceImpl, int methodId) {
  this.serviceImpl = serviceImpl;
  this.methodId = methodId;
  }
@@ -418,6 +416,24 @@ public io.grpc.stub.StreamObserver<Req> invoke(
  }
  }
 
+ public static final io.grpc.ServerServiceDefinition bindService(AsyncService service) {
+ return io.grpc.ServerServiceDefinition.builder(getServiceDescriptor())
+ .addMethod(
+ getListLocationsMethod(),
+ io.grpc.stub.ServerCalls.asyncUnaryCall(
+ new MethodHandlers<
+ com.google.cloud.location.ListLocationsRequest,
+ com.google.cloud.location.ListLocationsResponse>(
+ service, METHODID_LIST_LOCATIONS)))
+ .addMethod(
+ getGetLocationMethod(),
+ io.grpc.stub.ServerCalls.asyncUnaryCall(
+ new MethodHandlers<
+ com.google.cloud.location.GetLocationRequest,
+ com.google.cloud.location.Location>(service, METHODID_GET_LOCATION)))
+ .build();
+ }
+
  private abstract static class LocationsBaseDescriptorSupplier
  implements io.grpc.protobuf.ProtoFileDescriptorSupplier,
  io.grpc.protobuf.ProtoServiceDescriptorSupplier {

java-common-protos/grpc-google-common-protos/src/main/java/com/google/longrunning/OperationsGrpc.java

@@ -304,7 +304,7 @@ public OperationsFutureStub newStub(
  * so developers can have a consistent client experience.
  * </pre>
  */
- public abstract static class OperationsImplBase implements io.grpc.BindableService {
+ public interface AsyncService {
 
  /**
  *
@@ -321,7 +321,7 @@ public abstract static class OperationsImplBase implements io.grpc.BindableServi
  * is the parent resource, without the operations collection id.
  * </pre>
  */
- public void listOperations(
+ default void listOperations(
  com.google.longrunning.ListOperationsRequest request,
  io.grpc.stub.StreamObserver<com.google.longrunning.ListOperationsResponse>
  responseObserver) {
@@ -338,7 +338,7 @@ public void listOperations(
  * service.
  * </pre>
  */
- public void getOperation(
+ default void getOperation(
  com.google.longrunning.GetOperationRequest request,
  io.grpc.stub.StreamObserver<com.google.longrunning.Operation> responseObserver) {
  io.grpc.stub.ServerCalls.asyncUnimplementedUnaryCall(
@@ -355,7 +355,7 @@ public void getOperation(
  * `google.rpc.Code.UNIMPLEMENTED`.
  * </pre>
  */
- public void deleteOperation(
+ default void deleteOperation(
  com.google.longrunning.DeleteOperationRequest request,
  io.grpc.stub.StreamObserver<com.google.protobuf.Empty> responseObserver) {
  io.grpc.stub.ServerCalls.asyncUnimplementedUnaryCall(
@@ -378,7 +378,7 @@ public void deleteOperation(
  * corresponding to `Code.CANCELLED`.
  * </pre>
  */
- public void cancelOperation(
+ default void cancelOperation(
  com.google.longrunning.CancelOperationRequest request,
  io.grpc.stub.StreamObserver<com.google.protobuf.Empty> responseObserver) {
  io.grpc.stub.ServerCalls.asyncUnimplementedUnaryCall(
@@ -400,53 +400,38 @@ public void cancelOperation(
  * immediate response is no guarantee that the operation is done.
  * </pre>
  */
- public void waitOperation(
+ default void waitOperation(
  com.google.longrunning.WaitOperationRequest request,
  io.grpc.stub.StreamObserver<com.google.longrunning.Operation> responseObserver) {
  io.grpc.stub.ServerCalls.asyncUnimplementedUnaryCall(
  getWaitOperationMethod(), responseObserver);
  }
+ }
+
+ /**
+ * Base class for the server implementation of the service Operations.
+ *
+ * <pre>
+ * Manages long-running operations with an API service.
+ * When an API method normally takes long time to complete, it can be designed
+ * to return [Operation][google.longrunning.Operation] to the client, and the client can use this
+ * interface to receive the real response asynchronously by polling the
+ * operation resource, or pass the operation resource to another API (such as
+ * Google Cloud Pub/Sub API) to receive the response. Any API service that
+ * returns long-running operations should implement the `Operations` interface
+ * so developers can have a consistent client experience.
+ * </pre>
+ */
+ public abstract static class OperationsImplBase implements io.grpc.BindableService, AsyncService {
 
  @java.lang.Override
  public final io.grpc.ServerServiceDefinition bindService() {
- return io.grpc.ServerServiceDefinition.builder(getServiceDescriptor())
- .addMethod(
- getListOperationsMethod(),
- io.grpc.stub.ServerCalls.asyncUnaryCall(
- new MethodHandlers<
- com.google.longrunning.ListOperationsRequest,
- com.google.longrunning.ListOperationsResponse>(
- this, METHODID_LIST_OPERATIONS)))
- .addMethod(
- getGetOperationMethod(),
- io.grpc.stub.ServerCalls.asyncUnaryCall(
- new MethodHandlers<
- com.google.longrunning.GetOperationRequest, com.google.longrunning.Operation>(
- this, METHODID_GET_OPERATION)))
- .addMethod(
- getDeleteOperationMethod(),
- io.grpc.stub.ServerCalls.asyncUnaryCall(
- new MethodHandlers<
- com.google.longrunning.DeleteOperationRequest, com.google.protobuf.Empty>(
- this, METHODID_DELETE_OPERATION)))
- .addMethod(
- getCancelOperationMethod(),
- io.grpc.stub.ServerCalls.asyncUnaryCall(
- new MethodHandlers<
- com.google.longrunning.CancelOperationRequest, com.google.protobuf.Empty>(
- this, METHODID_CANCEL_OPERATION)))
- .addMethod(
- getWaitOperationMethod(),
- io.grpc.stub.ServerCalls.asyncUnaryCall(
- new MethodHandlers<
- com.google.longrunning.WaitOperationRequest,
- com.google.longrunning.Operation>(this, METHODID_WAIT_OPERATION)))
- .build();
+ return OperationsGrpc.bindService(this);
  }
  }
 
  /**
- *
+ * A stub to allow clients to do asynchronous rpc calls to service Operations.
  *
  * <pre>
  * Manages long-running operations with an API service.
@@ -582,7 +567,7 @@ public void waitOperation(
  }
 
  /**
- *
+ * A stub to allow clients to do synchronous rpc calls to service Operations.
  *
  * <pre>
  * Manages long-running operations with an API service.
@@ -704,7 +689,7 @@ public com.google.longrunning.Operation waitOperation(
  }
 
  /**
- *
+ * A stub to allow clients to do ListenableFuture-style rpc calls to service Operations.
  *
  * <pre>
  * Manages long-running operations with an API service.
@@ -836,10 +821,10 @@ private static final class MethodHandlers<Req, Resp>
  io.grpc.stub.ServerCalls.ServerStreamingMethod<Req, Resp>,
  io.grpc.stub.ServerCalls.ClientStreamingMethod<Req, Resp>,
  io.grpc.stub.ServerCalls.BidiStreamingMethod<Req, Resp> {
- private final OperationsImplBase serviceImpl;
+ private final AsyncService serviceImpl;
  private final int methodId;
 
- MethodHandlers(OperationsImplBase serviceImpl, int methodId) {
+ MethodHandlers(AsyncService serviceImpl, int methodId) {
  this.serviceImpl = serviceImpl;
  this.methodId = methodId;
  }
@@ -890,6 +875,42 @@ public io.grpc.stub.StreamObserver<Req> invoke(
  }
  }
 
+ public static final io.grpc.ServerServiceDefinition bindService(AsyncService service) {
+ return io.grpc.ServerServiceDefinition.builder(getServiceDescriptor())
+ .addMethod(
+ getListOperationsMethod(),
+ io.grpc.stub.ServerCalls.asyncUnaryCall(
+ new MethodHandlers<
+ com.google.longrunning.ListOperationsRequest,
+ com.google.longrunning.ListOperationsResponse>(
+ service, METHODID_LIST_OPERATIONS)))
+ .addMethod(
+ getGetOperationMethod(),
+ io.grpc.stub.ServerCalls.asyncUnaryCall(
+ new MethodHandlers<
+ com.google.longrunning.GetOperationRequest, com.google.longrunning.Operation>(
+ service, METHODID_GET_OPERATION)))
+ .addMethod(
+ getDeleteOperationMethod(),
+ io.grpc.stub.ServerCalls.asyncUnaryCall(
+ new MethodHandlers<
+ com.google.longrunning.DeleteOperationRequest, com.google.protobuf.Empty>(
+ service, METHODID_DELETE_OPERATION)))
+ .addMethod(
+ getCancelOperationMethod(),
+ io.grpc.stub.ServerCalls.asyncUnaryCall(
+ new MethodHandlers<
+ com.google.longrunning.CancelOperationRequest, com.google.protobuf.Empty>(
+ service, METHODID_CANCEL_OPERATION)))
+ .addMethod(
+ getWaitOperationMethod(),
+ io.grpc.stub.ServerCalls.asyncUnaryCall(
+ new MethodHandlers<
+ com.google.longrunning.WaitOperationRequest, com.google.longrunning.Operation>(
+ service, METHODID_WAIT_OPERATION)))
+ .build();
+ }
+
  private abstract static class OperationsBaseDescriptorSupplier
  implements io.grpc.protobuf.ProtoFileDescriptorSupplier,
  io.grpc.protobuf.ProtoServiceDescriptorSupplier {