v1.19.2

This release of the Nylas Java SDK comes with a few fixes.

Release Notes

Fixed

• Fix Event.hide_participants not serializing (#143)
• Fix Event.visibility not serializing (#143)
• Fix FreeBusy not having a calendar_id field (#143)

v1.19.1

This release of the Nylas Java SDK comes with a couple of changes.

Release Notes

Changed

• Added missing setters for FreeBusy (#140)

Fixed

• Fixed typo in Event.hide_participants (#140)

v1.19.0

This release of the Nylas Java SDK comes with new features, changes, and fixes.

Release Notes

Added

• Added support for calendar colors (for Microsoft calendars) (#107)
• Added support for rate limit errors (#112)

Changed

• Set Content-Type and Accept headers on outgoing calls (#113)

Fixed

• Fixed revoke access token always throwing an error (#111)
• Fixed participant status not serializing on Event creation (#124)

v1.18.0

This release of the Nylas Java SDK comes with new features and a bug fix.

Release Notes

Added

• Added hide participants field for the Event class (#103)
• Added support for provider detection (#100)
• Added an enum for all known providers for native authentication (#100)
• Improved webhook notification support with the addition of more notification attributes and event metadata fields (#102)

Changed

• NylasAccount.revokeAccessToken() returns a boolean value now (#97)

Fixed

• Fix error when updating occurrence of a recurring event (#93)

Using New Features

Provider Detection

// Set up your client
NylasClient client = new NylasClient();
NativeAuthentication nativeAuthentication = client.application("CLIENT_ID", "CLIENT_SECRET").nativeAuthentication();

// Detect the provider for an email address
NativeAuthentication.DetectedProvider detectedProvider = nativeAuthentication.detectProvider("test@gmail.com");
// The following fields are made available
detectedProvider.isDetected();
detectedProvider.getProviderName();
detectedProvider.getAuthName();
detectedProvider.getEmailAddress();
detectedProvider.isImap();

// You can use the result from above to get the correct provider settings
ProviderSettings detectedSettings = ProviderSettings.getProviderSettingsByProvider(provider.getAuthName());

// The enum is provided for consistency and equality
if(detectedProvider.getAuthName() == NativeAuthentication.Provider.GMAIL.getName()) {
  // do something here for a Gmail case
}

v1.17.0

This release of the Nylas Java SDK comes with a new feature and a bug fix.

Release Notes

Added

• Add support for getting a single expanded message and thread (#84)

Fixed

• Fixed issue where Event participants could never be entirely removed once set (#83)

Using New Features

Getting a single expanded message and thread

NylasClient nylas = new NylasClient();
NylasAccount account = nylas.account("{ACCESS_TOKEN}");

// Get an expanded message by passing a boolean for the second parameter, indicating an expanded view
Message expandedMessage = account.messages().get("message_id", true);

// Get an expanded thread by passing a boolean for the second parameter, indicating an expanded view
Thread expandedThread = account.threads().get("thread_id", true);

v1.16.0

This release of the Nylas Java SDK comes with a couple of additions.

Release Notes

Added

• Add missing event query parameters (#80)
• Add support for Event reminders (#80)
• Add support for additional Event fields (#80)

Using New Features

Event reminders

ZoneId startTz = ZoneId.of("America/Los_Angeles");
ZoneId endTz = ZoneId.of("America/New_York");
ZonedDateTime startTime = ZonedDateTime.now(startTz);
ZonedDateTime endTime = startTime.plusHours(2).withZoneSameInstant(endTz);

Event event = new Event("calendar_id", new Timespan(startTime, endTime));
event.setTitle("Surprise Party");

// Add event reminders
event.setReminders(new Event.Reminders(20, Event.Reminders.ReminderMethod.EMAIL));

// Create the event
Event created = events.create(event, true);

v1.15.0

This release of the Nylas Java SDK comes with a couple of additions.

Release Notes

Added

• Add interval_minutes field in Scheduler booking config (#77)
• Add metadata field to JobStatus (#78)

v1.14.0

This release of the Nylas Java SDK comes with a few new features and a fix.

Release Notes

Added

• Add missing fields in Scheduler (#71)
• Add support for collective and group events (#73)
• Add support for calendar free-busy scope (#75)
• Add redirect_on_error parameter for Hosted Authentication (#72)

Fixed

• Fixed enum value for Scheduler.Config.Booking.OpeningHours.Days.Sunday (#74)

New Contributors 🎉

• @maxw-nylas made their first contribution in #72

v1.13.1

This release of the Nylas Java SDK comes with a couple of changes.

Release Notes

Added

• Add missing order and emails fields in Availability and TimeSlot

Fixed

• Fixed Participant status not being sent to the API when set

v1.13.0

This release of the Nylas Java SDK comes with a few new features, changes, and fixes!

Release Notes

Added

• Added support for Delta
• Added support for new (beta) Integrations authentication (Integrations API, Grants API, Hosted Authentication for Integrations)
• Added authentication_type field to Account

Changed

• Bump supported API version to v2.5

Fixed

• Fixed incorrect property name for Event.Notification.minutes_before_event

Using New Features

Delta

To get the latest cursor:

NylasClient nylas = new NylasClient();
NylasAccount account = nylas.account("{ACCESS_TOKEN}");
Deltas deltas = account.deltas();

String latestCursor = deltas.latestCursor();

To return a set of delta cursors since a specific cursor:

NylasClient nylas = new NylasClient();
NylasAccount account = nylas.account("{ACCESS_TOKEN}");
Deltas deltas = account.deltas();

DeltaCursor deltaCursor = deltas.since("{CURSOR}");

// The returned type is of DeltaCursor
String cursorStart = deltaCursor.getCursorStart();
String cursorEnd = deltaCursor.getCursorEnd();
List<Delta<?>> deltas = deltaCursor.getDeltas();

// DeltaCursor.deltas contains a list of Delta objects
Delta<?> delta = deltas[0];
String deltaCursor = delta.getCursor();
String deltaEvent = delta.getEvent();
String deltaId = delta.getId();
String deltaObject = delta.getObject();

// The enclosed Delta.attributes instantiates the object provided in the Delta (Contact, File, etc.)
Event deltaAttributes = delta.attributes();

/**
* You can also pass in other optional arguments through DeltaQueryOptions:
* view: string - This type of view to return within the delta objects
* includeTypes: DeltaQueryOptions.Type... - The list of types to include in the query ('file', 'event', etc.)
* excludeTypes: DeltaQueryOptions.Type... - The list of types to exclude in the query ('file', 'event', etc.)
*/

DeltaQueryOptions options = new DeltaQueryOptions()
				.setView("expanded")
				.includeTypes(DeltaQueryOptions.Type.EVENT, DeltaQueryOptions.Type.MESSAGE);
DeltaCursor deltaCursor = deltas.since(cursor, options);

To stream for delta cursors since a specific cursor:

public class DeltaExample {

  public static void main(String[] args) throws RequestFailedException, IOException {
    NylasClient nylas = new NylasClient();
    NylasAccount account = nylas.account("{ACCESS_TOKEN}");
    Deltas deltas = account.deltas();

    // By default, the streaming function will listen indefinitely until the connection drops
    // and upon reaching the end it will return an array of delta objects captured
    List<Delta<?>> streamedDeltas = deltas.stream(latestCursor);

    // Optionally you can pass in a class that implements DeltaStreamListener that will invoke
    // onDelta(Delta<?>) on each Delta received
    DeltaProcessor deltaProcessor = new DeltaProcessor();
    streamedDeltas = deltas.stream(latestCursor, deltaProcessor);


    /**
    * You can also pass in other optional arguments through DeltaQueryOptions:
    * view: string - This type of view to return within the delta objects
    * includeTypes: DeltaQueryOptions.Type... - The list of types to include in the query ('file', 'event', etc.)
    * excludeTypes: DeltaQueryOptions.Type... - The list of types to exclude in the query ('file', 'event', etc.)
    */
    DeltaQueryOptions options = new DeltaQueryOptions()
        .setView("expanded")
        .includeTypes(DeltaQueryOptions.Type.EVENT, DeltaQueryOptions.Type.MESSAGE);
    streamedDeltas = deltas.stream(latestCursor, deltaProcessor, options);
  }
}

class DeltaProcessor implements DeltaStreamListener {

  @Override
  public void onDelta(Delta<? extends AccountOwnedModel> delta) {
    System.out.println("Delta received! " + delta);
  }
}

To long-poll for delta cursors since a specific cursor:

public class DeltaExample {

  public static void main(String[] args) throws RequestFailedException, IOException {
    NylasClient nylas = new NylasClient();
    NylasAccount account = nylas.account("{ACCESS_TOKEN}");
    Deltas deltas = account.deltas();

    // By default, the streaming function will listen until until the timeout is reached
    // and upon reaching the end it will return a DeltaCursor object
    DeltaCursor longPollDeltas = deltas.longpoll(latestCursor, 30); // timeout is in seconds

    // Optionally you can pass in a class that implements DeltaLongPollListener that will invoke
    // onDeltaCursor(DeltaCursor) on each DeltaCursor received
    DeltaProcessor deltaProcessor = new DeltaProcessor();
    longPollDeltas = deltas.longpoll(latestCursor, 30, deltaProcessor);


    /**
    * You can also pass in other optional arguments through DeltaQueryOptions:
    * view: string - This type of view to return within the delta objects
    * includeTypes: DeltaQueryOptions.Type... - The list of types to include in the query ('file', 'event', etc.)
    * excludeTypes: DeltaQueryOptions.Type... - The list of types to exclude in the query ('file', 'event', etc.)
    */
    DeltaQueryOptions options = new DeltaQueryOptions()
        .setView("expanded")
        .includeTypes(DeltaQueryOptions.Type.EVENT, DeltaQueryOptions.Type.MESSAGE);
    longPollDeltas = deltas.longpoll(latestCursor, 30, deltaProcessor, options);
  }
}

class DeltaProcessor implements DeltaLongPollListener {

  @Override
  public void onDeltaCursor(DeltaCursor deltaCursor) {
    System.out.println("Delta Cursor received! " + deltaCursor);
  }
}

Integration Authentication (Beta)

Integrations API

To list all integrations:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Integrations integrations = application.authentication().integrations();

List<Integration> allIntegrations = integrations.list();

To get an integration for a specific OAuth Provider:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Integrations integrations = application.authentication().integrations();

Integration zoom = integrations.get(Authentication.Provider.ZOOM);

To create a new integration (we will use Zoom for example):

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Integrations integrations = application.authentication().integrations();

Integration integration = new Integration("Test Zoom Integration");
integration.setClientId("zoom.client.id");
integration.setClientSecret("zoom.client.secret");
integration.addRedirectUris("https://www.nylas.com");
integration.setExpiresIn(1209600L);
Integration created = integrations.create(integration, Authentication.Provider.ZOOM);

To update an existing integration:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Integrations integrations = application.authentication().integrations();

Integration zoomIntegration = integrations.get(Authentication.Provider.ZOOM);
zoomIntegration.setName("Updated name");
integrations.update(zoomIntegration);

To delete an existing integration for a specific OAuth provider:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Integrations integrations = application.authentication().integrations();

integrations.delete(Authentication.Provider.ZOOM);

Grants

To list all grants:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Grants grants = application.authentication().grants();

List<Grant> allGrants = grants.list();

To get a specific grant:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Grants grants = application.authentication().grants();

Grant grant = grants.get("grant_id");

To create a new grant (we will use Zoom for example):

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Grants grants = application.authentication().grants();

Map<String, String> settings = Collections.singletonMap("refresh_token", "zoom_refresh_token"));
Grant grant = new Grant(Authentication.Provider.ZOOM, settings);
grant.setState("test_state");
grant.setScope(Collections.singletonList("meeting:write"));
grant.setMetadata(Collections.singletonMap("sdk", "Java SDK"));
Grant created = grants.create(grant);

To update an existing grant:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Grants grants = application.authentication().grants();

Grant grant = integrations.get("grant_id");
grant.setMetadata(Collections.singletonMap("sdk", "Java SDK"));
grants.update(grant);

To delete an existing grant:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Grants grants = application.authentication().grants();

grants.delete("grant_id");

To trigger a re-sync on a grant:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
Grants grants = application.authentication().grants();

Grant resyncedGrant = grants.onDemandSync("grant_id);

Hosted Authentication for Authentication

To begin the hosted authentication process and get a login url:

NylasClient nylas = new NylasClient();
NylasApplication application = client.application("CLIENT_ID", "CLIENT_SEC...