Overview (Salesforce Marketing Cloud Java SDK 1.2.2 API)

Packages
Package	Description
com.exacttarget.fuelsdk	Fuel Java SDK Core
com.exacttarget.fuelsdk.annotations
com.exacttarget.fuelsdk.internal

The Fuel Java SDK enables developers to easily access the Salesforce Marketing Cloud (formerly ExactTarget) from the Java platform. Among other things, the Java SDK:

automatically acquires and refreshes Marketing Cloud access tokens
enables developers to access both Marketing Cloud SOAP and REST APIs in the same session
exposes simplified versions of the most commonly used Marketing Cloud objects and methods as Java native objects
provides passthroughs so developers can access the full REST and SOAP APIs directly when they need to go beyond the simplified interfaces
adds "sugar" methods for the most commonly used Marketing Cloud features that make it easy to use those features (e.g., the SDK provides a SQL-like interface to data extensions)

To use the Java SDK, you first need to instantiate an ETClient object:

ETClient client = new ETClient();

The Java SDK is highly configurable. By default, configuration is read from a properties file named fuelsdk.properties, which should be located in your class path. Alternatively, you can pass in the path of the file to be read as an argument to the ETClient constructor:

ETClient client = new ETClient("fuelsdk.properties");

You can also pass in a programmatically constructed ETConfiguration object:

ETConfiguration configuration = new ETConfiguration();
configuration.setClientId("clientIdGoesHere");
configuration.setClientSecret("clientSecretGoesHere");

ETClient client = new ETClient(ETConfiguration);

Once the client has been initialized, you interacted with the API using its create, retrieve, update, and delete methods.

In addition, some objects (e.g., ETDataExtension and ETTriggeredEmail contain object native methods (e.g., insert, select, update, and delete for ETDataExtension and send for TriggeredEmail). For information on these object native methods, please see the class documentation.