When using a Cloud client library, it's important to distinguish between two types of versions:
Library Version: The version of the software package (the client library) that helps you interact with the Cloud service. These libraries are
released and updated frequently with bug fixes, improvements, and support for new service features and versions. The version selector at
the top of this page represents the client library version.
Version ID: The version of the Cloud service itself (e.g. Common Protos). New Version IDs are introduced infrequently, and often involve
changes to the core functionality and structure of the Cloud service itself. The packages in the lefthand navigation represent packages tied
to a specific Version ID of the Cloud service.
Managing Library Versions
We recommend using thecom.google.cloud:libraries-bominstallation method detailed above to streamline dependency management
across multiple Cloud Java client libraries. This ensures compatibility and simplifies updates.
Choosing the Right Version ID
Each Cloud Java client library may contain packages tied to specific Version IDs (e.g.,v1,v2alpha). For new production applications, use
the latest stable Version ID. This is identified by the highest version numberwithouta suffix (like "alpha" or "beta"). You can read more aboutCloud API versioning strategy here.
Important: Unstable Version ID releases (thosewithsuffixes) are subject to breaking changes when upgrading. Use them only for testing or if you specifically need their experimental features.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["Version latestkeyboard_arrow_down\n\n- [2.60.0 (latest)](/java/docs/reference/proto-google-common-protos/latest/overview)\n- [2.59.2](/java/docs/reference/proto-google-common-protos/2.59.2/overview)\n- [2.58.0](/java/docs/reference/proto-google-common-protos/2.58.0/overview)\n- [2.57.0](/java/docs/reference/proto-google-common-protos/2.57.0/overview)\n- [2.56.0](/java/docs/reference/proto-google-common-protos/2.56.0/overview)\n- [2.54.1](/java/docs/reference/proto-google-common-protos/2.54.1/overview)\n- [2.53.0](/java/docs/reference/proto-google-common-protos/2.53.0/overview)\n- [2.52.0](/java/docs/reference/proto-google-common-protos/2.52.0/overview)\n- [2.51.0](/java/docs/reference/proto-google-common-protos/2.51.0/overview)\n- [2.50.1](/java/docs/reference/proto-google-common-protos/2.50.1/overview)\n- [2.49.0](/java/docs/reference/proto-google-common-protos/2.49.0/overview)\n- [2.48.0](/java/docs/reference/proto-google-common-protos/2.48.0/overview)\n- [2.46.0](/java/docs/reference/proto-google-common-protos/2.46.0/overview)\n- [2.45.1](/java/docs/reference/proto-google-common-protos/2.45.1/overview)\n- [2.44.0](/java/docs/reference/proto-google-common-protos/2.44.0/overview)\n- [2.43.0](/java/docs/reference/proto-google-common-protos/2.43.0/overview)\n- [2.42.0](/java/docs/reference/proto-google-common-protos/2.42.0/overview)\n- [2.41.0](/java/docs/reference/proto-google-common-protos/2.41.0/overview)\n- [2.40.0](/java/docs/reference/proto-google-common-protos/2.40.0/overview)\n- [2.39.1](/java/docs/reference/proto-google-common-protos/2.39.1/overview)\n- [2.38.0](/java/docs/reference/proto-google-common-protos/2.38.0/overview)\n- [2.37.1](/java/docs/reference/proto-google-common-protos/2.37.1/overview)\n- [2.36.0](/java/docs/reference/proto-google-common-protos/2.36.0/overview)\n- [2.34.0](/java/docs/reference/proto-google-common-protos/2.34.0/overview)\n- [2.33.0](/java/docs/reference/proto-google-common-protos/2.33.0/overview)\n- [2.32.0](/java/docs/reference/proto-google-common-protos/2.32.0/overview)\n- [2.30.0](/java/docs/reference/proto-google-common-protos/2.30.0/overview)\n- [2.29.0](/java/docs/reference/proto-google-common-protos/2.29.0/overview)\n- [2.28.0](/java/docs/reference/proto-google-common-protos/2.28.0/overview)\n- [2.27.0](/java/docs/reference/proto-google-common-protos/2.27.0/overview)\n- [2.26.0](/java/docs/reference/proto-google-common-protos/2.26.0/overview)\n- [2.25.1](/java/docs/reference/proto-google-common-protos/2.25.1/overview)\n- [2.24.0](/java/docs/reference/proto-google-common-protos/2.24.0/overview)\n- [2.23.1](/java/docs/reference/proto-google-common-protos/2.23.1/overview)\n- [2.22.1](/java/docs/reference/proto-google-common-protos/2.22.1/overview)\n- [2.21.1](/java/docs/reference/proto-google-common-protos/2.21.1/overview)\n- [2.15.0](/java/docs/reference/proto-google-common-protos/2.15.0/overview)\n- [2.14.3](/java/docs/reference/proto-google-common-protos/2.14.3/overview)\n- [2.13.0](/java/docs/reference/proto-google-common-protos/2.13.0/overview)\n- [2.12.0](/java/docs/reference/proto-google-common-protos/2.12.0/overview)\n- [2.11.0](/java/docs/reference/proto-google-common-protos/2.11.0/overview)\n- [2.10.0](/java/docs/reference/proto-google-common-protos/2.10.0/overview)\n- [2.9.6](/java/docs/reference/proto-google-common-protos/2.9.6/overview)\n- [2.8.4](/java/docs/reference/proto-google-common-protos/2.8.4/overview)\n- [2.7.4](/java/docs/reference/proto-google-common-protos/2.7.4/overview) \n\nproto-google-common-protos overview (2.60.0)\n============================================\n\nKey Reference Links\n-------------------\n\n**Common Protos Description:** Protobuf classes for Google's common protos.\n\nGetting Started\n---------------\n\nIn order to use this library, you first need to go through the following steps:\n\n- [Install a JDK (Java Development Kit)](https://cloud.google.com/java/docs/setup#install_a_jdk_java_development_kit)\n\nWhich version ID should I get started with?\n-------------------------------------------\n\nFor this library, we recommend using [com.google.apps.card.v1](https://cloud.google.com/java/docs/reference/proto-google-common-protos/2.60.0/com.google.apps.card.v1) for new applications.\n\n### Understanding Version ID and Library Versions\n\nWhen using a Cloud client library, it's important to distinguish between two types of versions:\n\n- **Library Version**: The version of the software package (the client library) that helps you interact with the Cloud service. These libraries are released and updated frequently with bug fixes, improvements, and support for new service features and versions. The version selector at the top of this page represents the client library version.\n- **Version ID**: The version of the Cloud service itself (e.g. Common Protos). New Version IDs are introduced infrequently, and often involve changes to the core functionality and structure of the Cloud service itself. The packages in the lefthand navigation represent packages tied to a specific Version ID of the Cloud service.\n\n### Managing Library Versions\n\nWe recommend using the `com.google.cloud:libraries-bom` installation method detailed above to streamline dependency management\nacross multiple Cloud Java client libraries. This ensures compatibility and simplifies updates.\n\n### Choosing the Right Version ID\n\nEach Cloud Java client library may contain packages tied to specific Version IDs (e.g., `v1`, `v2alpha`). For new production applications, use\nthe latest stable Version ID. This is identified by the highest version number **without** a suffix (like \"alpha\" or \"beta\"). You can read more about\n[Cloud API versioning strategy here](https://cloud.google.com/apis/design/versioning).\n\n**Important** : Unstable Version ID releases (those *with* suffixes) are subject to breaking changes when upgrading. Use them only for testing or if you specifically need their experimental features."]]
