Releases · nylas/nylas-java

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...

Assets 2

08 Mar 17:54

mrashed-dev

v1.12.0

51f5d8a

v1.12.0

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

Release Notes

Added

Added Outbox support
Added support for Component CRUD
Added support for Neural Categorizer
Added support for calendar field in free-busy, availability, and consecutive availability queries
Added field for phone_number in Participant

Changed

Bump supported API version to v2.4

Fixed

Fix null error message when HostedAuthentication.fetchToken() returns an API error

Deprecated

Deprecated checkFreeBusy(Instant, Instant, List<String>) and checkFreeBusy(Instant, Instant, String) in favour of checkFreeBusy(FreeBusyQuery)

Using New Features

Outbox

To send a new message through the outbox:

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

// Create a new outbox message object
OutboxMessage message = new OutboxMessage();
message.setSubject("With Love, From Nylas");
message.setTo(Arrays.asList(new NameEmail("My Nylas Friend", "[email protected]")));
message.setBody("This email was sent using the Nylas email API. Visit https://nylas.com for details.");
message.setReplyTo(new NameEmail("Your Name", "[email protected]"));
message.setFrom(new NameEmail("Your Name", "[email protected]"));

// Set the outbox-specific parameters
Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DAY_OF_YEAR, 1);
Date tomorrow = calendar.getTime();
calendar.add(Calendar.DAY_OF_YEAR, 1);
Date dayAfter = calendar.getTime();

message.setSendAt(tomorrow);
message.setRetryLimitDatetime(dayAfter);

// Send the outbox message
OutboxJobStatus jobStatus = outbox.send(outboxMessage);

String outboxJobStatusId = jobStatus.getJobStatusId();
String outboxStatus = jobStatus.getStatus();
OutboxMessage sentMessage = jobStatus.getOriginalData();

You can also avoid creating an OutboxMessage type, you can just pass in a draft object to send:

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

// Create a new outbox message object
Draft draft = new Draft();
draft.setSubject("With Love, From Nylas");
draft.setTo(Arrays.asList(new NameEmail("My Nylas Friend", "[email protected]")));
draft.setBody("This email was sent using the Nylas email API. Visit https://nylas.com for details.");
draft.setReplyTo(new NameEmail("Your Name", "[email protected]"));
draft.setFrom(new NameEmail("Your Name", "[email protected]"));

// Prepare the outbox-specific parameters
Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DAY_OF_YEAR, 1);
Date tomorrow = calendar.getTime();
calendar.add(Calendar.DAY_OF_YEAR, 1);
Date dayAfter = calendar.getTime();

// Send the outbox message
OutboxJobStatus jobStatus = outbox.send(draft, tomorrow, dayAfter);

To update an outbox message after sending it

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

// Create and send the message object
OutboxMessage message = new OutboxMessage();
message.setSubject("With Love, From Nylas");
message.setTo(Arrays.asList(new NameEmail("My Nylas Friend", "[email protected]")));
message.setBody("This email was sent using the Nylas email API. Visit https://nylas.com for details.");
message.setReplyTo(new NameEmail("Your Name", "[email protected]"));
message.setFrom(new NameEmail("Your Name", "[email protected]"));

Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DAY_OF_YEAR, 1);
Date tomorrow = calendar.getTime();
calendar.add(Calendar.DAY_OF_YEAR, 1);
Date dayAfter = calendar.getTime();
message.setSendAt(tomorrow);
message.setRetryLimitDatetime(dayAfter);

OutboxJobStatus jobStatus = outbox.send(outboxMessage);

// Modify something in the job status
OutboxMessage sentMessage = jobStatus.getOriginalData();
calendar = Calendar.getInstance();
calendar.add(Calendar.HOUR_OF_DAY, 2);
Date newSendAt = calendar.getTime();

sentMessage.setSendAt(newSendAt);

// Update the outbox job
OutboxJobStatus updatedJobStatus = outbox.update(sentMessage, jobStatus.getJobStatusId());

To delete an outbox job

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

outbox.delete("JOB_STATUS_ID");

We also support SendGrid operations. To get the authentication and verification status

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

SendGridVerification verification = outbox.sendGridVerificationStatus();
verification.isDomainVerified();
verification.isSenderVerified();

To delete a SendGrid user:

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

outbox.deleteSendGridSubUser("email_address");

Component CRUD

To create a new component:

Component component = new Component();
component.setName("Java Component Test");
component.setType("agenda");
component.setPublicAccountId("ACCOUNT_ID");
component.setAccessToken(conf.get("access.token"));
component = application.components().save(component);

To get all components:

RemoteCollection<Component> componentList = application.components().list();

To get a specific component:

Component component = application.components().get("{COMPONENT_ID}");

To update a component:

Component component = application.components().get("{COMPONENT_ID}");
component.name = "Updated"
application.components().save(component);

To delete a component:

application.components().delete("{COMPONENT_ID}")

Neural Categorizer

To get the category of a message(s)

import com.nylas.NylasClient;
import com.nylas.NylasAccount;
import com.nylas.Neural;
import com.nylas.NeuralCategorizer;

import java.util.Collections;
import java.util.List;

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

    List<String> messageIds = Collections.singletonList("MESSAGEL_ID");
    List<NeuralCategorizer> categorizers = neural.categorize(messageIds);

    // The resulting object is an extension of a Message object with a categorize field
    NeuralCategorizer categorizer = categorizers.get(0);
    String category = categorizer.getCategorizer().getCategory();
    String modelVersion = categorizer.getCategorizer().getModelVersion();
    Long categorizedAt = categorizer.getCategorizer().getCategorizedAt();
    List<String> subcategories = categorizer.getCategorizer().getSubcategories();
  }
}

To recategorize a single message

import com.nylas.NylasClient;
import com.nylas.NylasAccount;
import com.nylas.Neural;
import com.nylas.NeuralCategorizer.Category;

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

    // NeuralCategorizer.Category options are "CONVERSATION" and "FEED"
    neural.reCategorize("MESSAGEL_ID", Category.CONVERSATION);
  }
}

New `calendar` field in free-busy, availability, and consecutive availability queries

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

// To check free-busy with calendars:
FreeBusyCalendars freeBusyCalendars = new FreeBusyCalendars();
freeBusyCalendars.setAccountId("test_account_id");
freeBusyCalendars.addCalendarIds("example_calendar_id_A", "example_calendar_id_B");

FreeBusyQuery query = new FreeBusyQuery()
	.startTime(1590454800)
	.endTime(1590780800)
	.calendars(freeBusyCalendars);
List<FreeBusy> freeBusyInfo = calendars.checkFreeBusy(query);

// To check availability with calendars:
SingleAvailabilityQuery query = new SingleAvailabilityQuery()
	.durationMinutes(30)
	.startTime(Instant.now())
	.endTime(Instant.now().plus(1, ChronoUnit.HOURS))
	.intervalMinutes(10)
	.calendars(freeBusyCalendars);

Availability availability = calendars.availability(query);

// To check consecutive availability with calendars:
MultipleAvailabilityQuery consecutiveQuery = new MultipleAvailabilityQuery()
	.durationMinutes(30)
	.startTime(Instant.now())
	.endTime(Instant.now().plus(1, ChronoUnit.HOURS))
	.intervalMinutes(10)
	.calendars(freeBusyCalendars);

List<List<ConsecutiveAvailability>> consecutiveAvailability = calendars.consecutiveAvailability(consecutiveQuery);

Assets 2

01 Feb 21:59

mrashed-dev

v1.11.2

060c6da

v1.11.2

Enhancements

Remove use of okhttp3.internal library

Assets 2

25 Jan 02:51

mrashed-dev

v1.11.1

5c2c0bf

v1.11.1

Enhancements

Fixed bug where an IllegalArgumentException is thrown when deserializing Draft with `metadata

Assets 2

20 Jan 19:06

mrashed-dev

v1.11.0

5506ba4

v1.11.0

This release of the Nylas Java SDK brings forward a handful of new features, including support for our Scheduler API.

New Features

Added support for Scheduler API
Added support for calendar availability
Added support for Event to ICS file generation
Added support for modifying Folder
Expanded metadata support for Calendar, Account, Message, and Draft

New Contributors

This is a new section that will be used to highlight all the wonderful people who have provided their first contribution to this project!

@TDtianzhenjiu made their first contribution with Add metadata field for message (#43)

Using New Features

Scheduler API

To create a new Scheduler page:

Scheduler scheduler = new Scheduler();
scheduler.addAccessTokens("access.token");
scheduler.setName("Java SDK Example");
scheduler.setSlug("java_example");
nylas.schedulers().save(scheduler);

To return all Scheduler pages:

List<Scheduler> schedulerList = nylas.schedulers().list();

To return a single Scheduler page:

Scheduler scheduler = nylas.schedulers().get("SCHEDULER_ID");

To update a Scheduler page:

Scheduler scheduler = nylas.schedulers().get("SCHEDULER_ID");
scheduler.name = "Updated page name"
nylas.schedulers().save(scheduler);

To delete a Scheduler page:

nylas.schedulers().delete("SCHEDULER_ID");

To get available calendars for a Scheduler page:

Scheduler scheduler = nylas.schedulers().get("SCHEDULER_ID");
List<AvailableCalendars> availableCalendars = nylas.schedulers().getAvailableCalendars(scheduler.getId());

To upload an image:

Scheduler scheduler = nylas.schedulers().get("SCHEDULER_ID");
UploadImageResponse uploadImageResponse = nylas.schedulers().uploadImage(scheduler.getId(), "image/png", "test.png");

Checking Provider Availability

// Google Availability
List<ProviderAvailability> googleAvailability = nylas.schedulers().getGoogleAvailability();

// Office 365 Availability
List<ProviderAvailability> office365Availability = nylas.schedulers().getOffice365Availability();

Get page information/configuration

Scheduler page = nylas.schedulers().getPageBySlug(scheduler.getSlug());

Retrieve available time slots

List<TimeSlot> timeSlots = nylas.schedulers().getAvailableTimeSlots(scheduler.getSlug());

Book a time slot

TimeSlot slot = new TimeSlot();
slot.setAccountId("test-account-id");
slot.setCalendarId("test-calendar-id");
slot.setEmails(Collections.singletonList("[email protected]"));
slot.setHostName("Host");
slot.setStart(1636728347L);
slot.setEnd(1636728347L);

BookingRequest bookingRequest = new BookingRequest();
Map<String, Object> additionalValues = new HashMap<>();
additionalValues.put("important", true);
bookingRequest.setAdditionalValues(additionalValues);
bookingRequest.setEmail("[email protected]");
bookingRequest.setLocale("en_US");
bookingRequest.setName("John Doe");
bookingRequest.setTimezone("America/New_York");
bookingRequest.setSlot(slot);

BookingConfirmation bookingConfirmation = nylas.schedulers().bookTimeSlot("slug", bookingRequest);

Confirm a booking

BookingConfirmation bookingConfirmation = nylas.schedulers().confirmBooking("slug", "edit-hash");

Cancel a booking

nylas.schedulers().cancelBooking("slug", "edit-hash", "reason");

Checking Calendar Availability

To check availability for a single meeting

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

// Prepare OpenHours for availability request
OpenHours openHours = new OpenHours();
openHours.setEmails(Collections.singletonList("[email protected]"));
openHours.setDays(Collections.singletonList(0));
openHours.setTimezone("America/Chicago");
openHours.setStart("10:00");
openHours.setEnd("14:00");

// Build availability request
SingleAvailabilityQuery query = new SingleAvailabilityQuery()
		.durationMinutes(30)
		.buffer(30)
		.startTime(Instant.now())
		.endTime(Instant.now().plus(1, ChronoUnit.HOURS))
		.emails(Collections.singletonList("[email protected]"));
		.intervalMinutes(5);

// Get availability
Availability availability = calendars.availability(query);

To check availability for a multiple meetings

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

// Prepare emails for availability request
List<List<String>> emails = new ArrayList<>();
emails.add(Collections.singletonList("[email protected]"));
emails.add(Collections.singletonList("[email protected]"));

// Prepare OpenHours for availability request
OpenHours openHours = new OpenHours();
List<String> openHoursEmails = new ArrayList<>();
openHoursEmails.add("[email protected]");
openHoursEmails.add("[email protected]");
openHours.setEmails(openHoursEmails);
openHours.setDays(Collections.singletonList(0));
openHours.setTimezone("America/Chicago");
openHours.setStart("10:00");
openHours.setEnd("14:00");

// Build availability request
MultipleAvailabilityQuery consecutiveQuery = new MultipleAvailabilityQuery()
		.durationMinutes(30)
		.buffer(30)
		.startTime(Instant.now())
		.endTime(Instant.now().plus(1, ChronoUnit.HOURS))
		.emails(emails)
		.openHours(Collections.singletonList(openHours))
		.intervalMinutes(5);

// Get consecutive availability
List<List<ConsecutiveAvailability>> consecutiveAvailability = calendars.consecutiveAvailability(consecutiveQuery);

Generating an ICS from an `Event`

NylasClient nylas = new NylasClient();
NylasAccount account = nylas.account("{ACCESS_TOKEN}");
Events events = account.events();
Event event = events.get("{eventId}");

// You can make an ICS file from an event ID
String icsFromEventID = events.generateICS(event.getId());

// You can make an ICS file from an Event object
String icsFromEvent = events.generateICS(event);

// You can also pass ICS Options for more configuration
ICSOptions icsOptions = new ICSOptions();
icsOptions.setIcal_uid("test_uuid");
icsOptions.setMethod(ICSMethod.ADD);
icsOptions.setProdid("test_prodid");

String icsFromEventWithOptions = events.generateICS(event, icsOptions);

Modifying a `Folder`

NylasClient nylas = new NylasClient();
NylasAccount account = nylas.account("{ACCESS_TOKEN}");
Folders folders = account.folders();
Folder folder = folders.get("{folderId}");

folder.setDisplayName("Updated name");
folder.setName("sent");

Folder updated = folders.update(folder);

Expanded Metadata

Adding Metadata to Calendar

Calendar newCal = new Calendar();
newCal.setName("New Test Calendar");
newCal.setDescription("Testing calendar creation");
newCal.setLocation("far, far away");
newCal.setTimezone("America/Los_Angeles");

Map<String, String> metadata = new HashMap<>();
metadata.put("calendar_type", "test");
newCal.setMetadata(metadata);

Calendar created = calendars.create(newCal);

// Or you can update a calendar with metadata

Map<String, String> metadata = new HashMap<>();
metadata.put("calendar_type", "test");
calendar.setMetadata(metadata);
Calendar updatedCalendar = account.calendars().update(calendar);

Query Calendars by Metadata

CalendarQuery metadataQuery = new CalendarQuery().metadataKey("calendar_type");
List<Calendar> calendarsWithMetadata = account.calendars().list(metadataQuery).fetchAll();
Calendar calendar = calendarsWithMetadata.get(0);

Adding Metadata to Draft

Draft draft = new Draft();
Map<String, String> metadata = new HashMap<>();
metadata.put("message_type", "test");
draft.setMetadata(metadata);

Adding Metadata to Message

Map<String, String> metadata = new HashMap<>();
metadata.put("message_type", "test");
Message message = account.messages().setMetadata("{EXISTING_MESSAGE_ID}", metadata);

Adding Metadata to Account

Map<String, String> metadata = new HashMap<>();
metadata.put("account_type", "test");
Account account = account.accounts().setMetadata("{EXISTING_ACCOUNT_ID}", metadata);

Query Account by Metadata

AccountQuery metadataQuery = new AccountQuery().metadataKey("account_type");
List<Account> accountsWithMetadata = account.accounts().list(metadataQuery).fetchAll();
Account account = accountsWithMetadata.get(0);

Contributors

TDtianzhenjiu

Assets 2

05 Jan 21:38

mrashed-dev

v1.10.3

30730fa

v1.10.3

Enhancements

Added support for the forced_password Hosted Auth setting
Added missing EMAIL scope
Fixed bug where saving an event without participants threw a NullPointerException

Assets 2

23 Dec 17:20

mrashed-dev

v1.10.2

0efe7ce

v1.10.2

Changed

Added false parameter when notifyParticipants is false

Security

Address major log4j vulnerability, updated log4j to v2.17.0

Assets 2

Releases: nylas/nylas-java

v1.15.0

Release Notes

Added

v1.14.0

Release Notes

Added

Fixed

New Contributors 🎉

Contributors

v1.13.1

Release Notes

Added

Fixed

v1.13.0

Release Notes

Added

Changed

Fixed

Using New Features

Delta

Integration Authentication (Beta)

Integrations API

Grants

Hosted Authentication for Authentication

v1.12.0

Release Notes

Added

Changed

Fixed

Deprecated

Using New Features

Outbox

Component CRUD

Neural Categorizer

New calendar field in free-busy, availability, and consecutive availability queries

v1.11.2

Enhancements

v1.11.1

Enhancements

v1.11.0

New Features

New Contributors

Using New Features

Scheduler API

Checking Calendar Availability

Generating an ICS from an Event

Modifying a Folder

Expanded Metadata

Contributors

v1.10.3

Enhancements

v1.10.2

Changed

Security

New `calendar` field in free-busy, availability, and consecutive availability queries

Generating an ICS from an `Event`

Modifying a `Folder`