diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index 16d21ef0f9..64ea4adf7c 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -114,6 +114,12 @@ public static List createClassHeaderComments( classHeaderJavadocBuilder = classHeaderJavadocBuilder.addUnescapedComment(descriptionComment); } + // Include google.api.api_version breadcrumb comment. + if (service.hasApiVersion()) { + classHeaderJavadocBuilder.addParagraph( + String.format("This client uses %s version %s.", service.name(), service.apiVersion())); + } + // Service introduction. classHeaderJavadocBuilder.addParagraph(SERVICE_DESCRIPTION_INTRO_STRING); classHeaderJavadocBuilder.addSampleCode(classMethodSampleCode); diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index bf68adf425..91e167d4e1 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -30,8 +30,10 @@ import javax.annotation.Generated; // AUTO-GENERATED DOCUMENTATION AND CLASS. /** - * 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: + * This client uses Echo version foo_version_for_tests. + * + *

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: * *

{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
diff --git a/java-showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java b/java-showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java
index 5f0a0b0a3d..1a2b9d3fa5 100644
--- a/java-showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java
+++ b/java-showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java
@@ -59,6 +59,8 @@
  * 'x-goog-request-params' metadata key on any method to have the values echoed in the response
  * headers.
  *
+ * 

This client uses Echo version v1_20240408. + * *

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: *