[Document]: HealthcareApiClient methods.

[svetakvsundhar]

Fixes #28415.

Several methods are undocumented in the HealthcareApiClient. We should document these parameters for better user experience, given that the user will not have access to the client libraries being used under the hood.

---

Thank you for your contribution! Follow this checklist to help us incorporate your contribution quickly and easily:

• Mention the appropriate issue in your description (for example: addresses #123), if applicable. This will automatically add a link to the pull request in the issue. If you would like the issue to automatically close on merging the pull request, comment fixes #<ISSUE NUMBER> instead.
• Update CHANGES.md with noteworthy changes.
• If this contribution is large, please file an Apache Individual Contributor License Agreement.

See the Contributor Guide for more tips on how to make review process smoother.

To check the build health, please visit https://github.com/apache/beam/blob/master/.test-infra/BUILD_STATUS.md

GitHub Actions Tests Status (on master branch)

See CI.md for more information about GitHub Actions CI or the workflows README to see a list of phrases to trigger workflows.

[svetakvsundhar]

R: @Abacn for committer review
R: @rachelgagnon for domain review

[github-actions]

Stopping reviewer notifications for this pull request: review requested by someone other than the bot, ceding control

[github-actions]

Test Results

1 750 tests  +1 708   1 580 ✔️ +1 538   13m 28s ⏱️ + 9m 17s
   154 suites +   147      170 💤 +   170 
   154 files   +   147          0 ❌ ±       0 

Results for commit 6990f02. ± Comparison against base commit ec422db.

This pull request removes 42 and adds 1750 tests. Note that renamed tests count towards both.

org.apache.beam.sdk.io.hbase.HBaseCoderProviderRegistrarTest ‑ testMutationCoderIsRegistered
org.apache.beam.sdk.io.hbase.HBaseCoderProviderRegistrarTest ‑ testResultCoderIsRegistered
org.apache.beam.sdk.io.hbase.HBaseCoderProviderRegistrarTest ‑ testRowMutationsCoderIsRegistered
org.apache.beam.sdk.io.hbase.HBaseIOTest ‑ testReadBuildsCorrectly
org.apache.beam.sdk.io.hbase.HBaseIOTest ‑ testReadBuildsCorrectlyInDifferentOrder
org.apache.beam.sdk.io.hbase.HBaseIOTest ‑ testReading
org.apache.beam.sdk.io.hbase.HBaseIOTest ‑ testReadingDisplayData
org.apache.beam.sdk.io.hbase.HBaseIOTest ‑ testReadingEmptyTable
org.apache.beam.sdk.io.hbase.HBaseIOTest ‑ testReadingFailsTableDoesNotExist
org.apache.beam.sdk.io.hbase.HBaseIOTest ‑ testReadingKeyRangeMiddle
…

org.apache.beam.sdk.io.gcp.GcpApiSurfaceTest ‑ testGcpApiSurface
org.apache.beam.sdk.io.gcp.bigquery.AvroGenericRecordToStorageApiProtoTest ‑ testCdcFields
org.apache.beam.sdk.io.gcp.bigquery.AvroGenericRecordToStorageApiProtoTest ‑ testDescriptorFromSchema
org.apache.beam.sdk.io.gcp.bigquery.AvroGenericRecordToStorageApiProtoTest ‑ testDescriptorFromSchemaLogicalTypes
org.apache.beam.sdk.io.gcp.bigquery.AvroGenericRecordToStorageApiProtoTest ‑ testMessageFromGenericRecord
org.apache.beam.sdk.io.gcp.bigquery.AvroGenericRecordToStorageApiProtoTest ‑ testMessageFromGenericRecordLogicalTypes
org.apache.beam.sdk.io.gcp.bigquery.AvroGenericRecordToStorageApiProtoTest ‑ testNestedFromSchema
org.apache.beam.sdk.io.gcp.bigquery.BeamRowToStorageApiProtoTest ‑ testCdcFields
org.apache.beam.sdk.io.gcp.bigquery.BeamRowToStorageApiProtoTest ‑ testDescriptorFromSchema
org.apache.beam.sdk.io.gcp.bigquery.BeamRowToStorageApiProtoTest ‑ testMessageFromTableRow
…

♻️ This comment has been updated with latest results.

[Abacn]

Spotless error: Error: eckstyle] [ERROR] /runner/_work/beam/beam/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/healthcare/HealthcareApiClient.java:194:6: Unused @param tag for 'fhirStore'. [JavadocMethod]

[svetakvsundhar]

Spotless error: Error: eckstyle] [ERROR] /runner/_work/beam/beam/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/healthcare/HealthcareApiClient.java:194:6: Unused @param tag for 'fhirStore'. [JavadocMethod]

whoops. should be fixed in new commit.

[svetakvsundhar]

Run Java_GCP_IO_Direct PreCommit

[rachelgagnon]

lgtm

[rachelgagnon]

lgtm