• Install a JDK (Java Development Kit)

Which version ID should I get started with?

For this library, we recommend usingcom.google.apps.card.v1 for new applications.

Understanding Version ID and Library Versions

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 arereleased and updated frequently with bug fixes, improvements, and support for new service features and versions. The version selector atthe 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 involvechanges to the core functionality and structure of the Cloud service itself. The packages in the lefthand navigation represent packages tiedto a specific Version ID of the Cloud service.

Managing Library Versions

We recommend using thecom.google.cloud:libraries-bom installation method detailed above to streamline dependency managementacross 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, usethe latest stable Version ID. This is identified by the highest version numberwithout a suffix (like "alpha" or "beta"). You can read more aboutCloud API versioning strategy here.

Important: Unstable Version ID releases (thosewith suffixes) are subject to breaking changes when upgrading. Use them only for testing or if you specifically need their experimental features.