• Install a JDK (Java Development Kit)
• Select or create a Cloud Platform project
• Enable billing for your project
• Enable the API
• Set up authentication

Use the Google Workspace Add-ons API for Java

To ensure that your project uses compatible versions of the librariesand their component artifacts, importcom.google.cloud:libraries-bom and usethe BOM to specify dependency versions. Be sure to remove any versions that youset previously. For more information aboutBOMs, seeGoogle Cloud Platform Libraries BOM.

Maven

Import the BOM in thedependencyManagement section of yourpom.xml file.Include specific artifacts you depend on in thedependencies section, but don'tspecify the artifacts' versions in thedependencies section.

The example below demonstrates how you would import the BOM and include thegoogle-cloud-gsuite-addons artifact.

<dependencyManagement><dependencies><dependency><groupId>com.google.cloud</groupId><artifactId>libraries-bom</artifactId><version>26.28.0</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement><dependencies><dependency><groupId>com.google.cloud</groupId><artifactId>google-cloud-gsuite-addons</artifactId></dependency></dependencies>

Gradle

BOMs are supported by default in Gradle 5.x or later. Add aplatformdependency oncom.google.cloud:libraries-bom and remove the version from thedependency declarations in the artifact'sbuild.gradle file.

The example below demonstrates how you would import the BOM and include thegoogle-cloud-gsuite-addons artifact.

implementationplatform('com.google.cloud:libraries-bom:  26.28.0')implementation'com.google.cloud:google-cloud-gsuite-addons'

Theplatform andenforcedPlatform keywords supply dependency versionsdeclared in a BOM. TheenforcedPlatform keyword enforces the dependencyversions declared in the BOM and thus overrides what you specified.

For more details of theplatform andenforcedPlatform keywords Gradle 5.x or higher, seeGradle: Importing Maven BOMs.

If you're using Gradle 4.6 or later, addenableFeaturePreview('IMPROVED_POM_SUPPORT') to yoursettings.gradle file. For details, seeGradle 4.6 Release Notes: BOM import.Versions of Gradle earlier than 4.6 don't support BOMs.

SBT

SBTdoesn't support BOMs. You can findrecommended versions of libraries from a particular BOM version on thedashboardand set the versions manually.To use the latest version of this library, add this to your dependencies:

libraryDependencies+="com.google.cloud"%"google-cloud-gsuite-addons"%"2.31.0"

Which version should I use?

For this library, we recommend using API version v1 for new applications.

Each Cloud Java client library may contain multiple packages. Each package containing a version number in its name corresponds to a published version of the service.We recommend using the latest stable version for new production applications, which can be identified by the largest numeric version that does not contain a suffix.For example, if a client library has two packages:v1 andv2alpha, then the latest stable version isv1.If you use an unstable release, breaking changes may be introduced when upgrading.You can read more aboutCloud API versioning strategy here.