Skip to content

Latest commit

 

History

History
 
 

README.md

Google Eventarc Client for Java

Java idiomatic client for Eventarc.

Maven Stability

Quickstart

If you are using Maven with BOM, add this to your pom.xml file:

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

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-eventarc</artifactId>
  </dependency>
</dependencies>

If you are using Maven without the BOM, add this to your dependencies:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-eventarc</artifactId>
  <version>1.52.0</version>
</dependency>

If you are using Gradle without BOM, add this to your dependencies:

implementation 'com.google.cloud:google-cloud-eventarc:1.52.0'

If you are using SBT, add this to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-eventarc" % "1.52.0"

Authentication

See the Authentication section in the base directory's README.

Authorization

The client application making API calls must be granted authorization scopes required for the desired Eventarc APIs, and the authenticated principal must have the IAM role(s) required to access GCP resources using the Eventarc API calls.

Getting Started

Prerequisites

You will need a Google Cloud Platform Console project with the Eventarc API enabled. You will need to enable billing to use Google Eventarc. Follow these instructions to get your project set up. You will also need to set up the local development environment by installing the Google Cloud Command Line Interface and running the following commands in command line: gcloud auth login and gcloud config set project [YOUR PROJECT ID].

Installation and setup

You'll need to obtain the google-cloud-eventarc library. See the Quickstart section to add google-cloud-eventarc as a dependency in your code.

About Eventarc

Eventarc lets you asynchronously deliver events from Google services, SaaS, and your own apps using loosely coupled services that react to state changes. Eventarc requires no infrastructure management, you can optimize productivity and costs while building a modern, event-driven solution.

See the Eventarc client library docs to learn how to use this Eventarc Client Library.

Troubleshooting

To get help, follow the instructions in the shared Troubleshooting document.

Transport

Eventarc uses both gRPC and HTTP/JSON for the transport layer.

Supported Java Versions

Java 8 or above is required for using this client.

Google's Java client libraries, Google Cloud Client Libraries and