GETTING STARTED
ICALENDAR

You can access actions using the iCalendar format.
"iCalendar is a computer file format which allows Internet users to send meeting requests and tasks to other Internet users, via email, or sharing files with an extension of .ics. Recipients of the iCalendar data file (with supporting software, such as an email client or calendar application) can respond to the sender easily or counter-propose another meeting date/time" - wikipedia
mydigitalstructure supports the VEVENT object only.
METHODS

ACTION_SEND_AS_ICS (ACTION_SEND_AS_ICALENDAR)

ACTION_ICAL_SEARCH (ACTION_ICALENDAR_SEARCH)

ACTION_ICALENDAR_MANAGE

SUBSCRIBING TO CALENDAR FEED

Typically the "other calendar" subscribes to a URL that returns the all the future calendar events (actions within mydigitalstructure) in the iCalendar format.

Given that this information is secure, you need to include an access token with the URL.

Note: It is important that you protect this access token - if someone gets access to it, they then have access to your information until you disable it.

You can generate this access token by logging on to a 1blankspace app or the console.mydigitalstructure.com app.

Once logged on, click your username (top right) and then select "Secure Access Token" and follow the instructions.

You will end up with URL like:

https://app.1blankspace/rpc/action/?method=ACTION_ICAL_SEARCH&access_token=1234-00f518er47ddas19c47a072864asfaa30b7fee
EXAMPLE SUBSCRIBING WITH APPLE IOS
1. Navigate to Settings -> Mail, Contacts, Calendars -> Add Account
2. Select Other -> Add Subscribed Calendar
3. Enter the URL you just generated and touch Next
4. Touch Save
EXAMPLE IMPORTING INTO GOOGLE CALENDAR
Select Add by URL and enter the URL you just generated with the secure token.

NOTE: [@ MAR2015]: We have discovered the Google Calendar "Add by URL" has a significant flaw, in that it only refreshes the URL every 6 hours (yes you read that correctly).

icalendar-google-import
EXAMPLE SYNCING WITH ANDROID CALENDAR
Given the issue with the slow periodic refresh with Google Calendar "Add by URL" and given it is the default calendar on Andriod based devices, you may need to consider using a sync agent on the device... read this for starting point.
DEEPER SYNCHRONISATION

Using Google API.

Like an email Inbox based on on IMAP integration, you can access new actions/events with a "Calendar Inbox" within the mydigitalstructure based app - similar to how the iOS calendar works.

 

 
ACTION ENDPOINT
About iCalendar
Google Calendar Subcribing
iCalendar Spec