Skip to content

build: Remove @InternalApi from GAPIC Admin Base clients#2834

Open
jinseopkim0 wants to merge 4 commits intomainfrom
owlbot-fix
Open

build: Remove @InternalApi from GAPIC Admin Base clients#2834
jinseopkim0 wants to merge 4 commits intomainfrom
owlbot-fix

Conversation

@jinseopkim0
Copy link
Contributor

@jinseopkim0 jinseopkim0 commented Mar 6, 2026

Updates owlbot.py to stop injecting @InternalApi into BaseBigtableTableAdminClient, BaseBigtableInstanceAdminClient, and their respective Settings classes.

Since we recently exposed these Base classes to users via getBaseClient() as part of the GAPIC modernization effort, they are now part of the public API surface and should no longer be marked as internal.

Tracking Bug: b/475818901

Updates owlbot.py to stop injecting `@InternalApi` into `BaseBigtableTableAdminClient`, `BaseBigtableInstanceAdminClient`, and their respective Settings classes.

Since we recently exposed these Base classes to users via `getBaseClient()` as part of the GAPIC modernization effort, they are now part of the public API surface and should no longer be marked as internal. Stubs remain marked as internal.

Tracking Bug: b/475818901
@product-auto-label product-auto-label bot added size: xs Pull request size is extra small. api: bigtable Issues related to the googleapis/java-bigtable API. labels Mar 6, 2026
@jinseopkim0 jinseopkim0 marked this pull request as ready for review March 6, 2026 17:27
@jinseopkim0 jinseopkim0 requested review from a team as code owners March 6, 2026 17:27
@jinseopkim0 jinseopkim0 requested a review from lqiu96 March 6, 2026 17:27
@product-auto-label product-auto-label bot added size: xl Pull request size is extra large. and removed size: xs Pull request size is extra small. labels Mar 6, 2026
@generated-files-bot
Copy link

Warning: This pull request is touching the following templated files:

  • google-cloud-bigtable/src/main/java/com/google/cloud/bigtable/admin/v2/BaseBigtableInstanceAdminClient.java
  • google-cloud-bigtable/src/main/java/com/google/cloud/bigtable/admin/v2/BaseBigtableInstanceAdminSettings.java
  • google-cloud-bigtable/src/main/java/com/google/cloud/bigtable/admin/v2/BaseBigtableTableAdminClient.java
  • google-cloud-bigtable/src/main/java/com/google/cloud/bigtable/admin/v2/BaseBigtableTableAdminSettings.java

jinseopkim0 added a commit that referenced this pull request Mar 6, 2026
In PR #2834, we removed the @internalapi annotations from the Admin API
stub classes to align with a vanilla GAPIC surface. Because they are no
longer internal, we must expose them in the public Javadoc reference
documentation so that power users can use them for advanced configuration
and custom transports.

This commit updates the `pom.xml` file to:
- Remove `sourceFileExclude` entries for Admin API stub classes in the
  `maven-javadoc-plugin` configuration.
- Update the `docFX` regex to stop excluding `stub.*` classes for the
  `admin.v2` package.
Comment on lines +85 to +89
/**
* Base stub class for the BigtableInstanceAdmin service API.
*
* <p>This class is for advanced usage and reflects the underlying API directly.
*/
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just to confirm: This is the generated comment from the generator right? Otherwise this custom comment would be overwritten on the next generation

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api: bigtable Issues related to the googleapis/java-bigtable API. size: xl Pull request size is extra large.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants