GETTING STARTED
|
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). |
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.
|
ACTION ENDPOINT |
About iCalendar |
Google Calendar Subcribing |
iCalendar Spec |