[59707] Java SDK support for metadata for events

[mrashed-dev]

Description

The Nylas Calendar API has a new beta feature of adding a new metadata field to calendar events. This PR makes the feature available via the Nylas Java SDK.

Usage

To create a new event with event metadata, you can create a Map<String, String> with a mapping of key-value pairs for the metadata:

Event event = new Event(calendarId, new Timespan(startTime, endTime));
....
Map<String, String> metadata = new HashMap<>();
metadata.put("event_category", "gathering");
event.setMetadata(metadata);

To query events based on metadata, you can filter on three different parameters:

• metadata_key (string or array) to filter based on the keys within the metadata object
• metadata_value (string or array) to filter based on the value within the metadata object
• metadata_pair (pair of strings; a key and a value) to filter based on the key-value pairs within the metadata object

You can invoke them as such and even chain them:

EventQuery query = new EventQuery()
                .calendarId(calendarId)
                .metadataKey("visitors", "parking")
                .metadataValue("garden")
                .metadataPair("event_category", "gathering");

License

I confirm that this contribution is made under the terms of the MIT license and that I have the authority necessary to make this contribution on behalf of its copyright owner.

[shortcut-integration]

This pull request has been linked to Clubhouse Story #59707: Java SDK support for metadata for events.

[ddlatham]

Left a couple comments. I also have a few question still for @rajeev2gupta in this story that I'd like to pin down before merging this in. May require some additional documentation:
https://app.clubhouse.io/nylas/story/57542/java-sdk-support-for-metadata-for-events

[ddlatham]

Looks good to merge!