|
- Properties specific to the description of gglEvent variables
- Managing the dates and their time zone
gglEvent (Type of variable) In french: gglEvénement (Type de variable)
The gglEvent type is used to describe and modify an event of a calendar. The calendar is described via the gglCalendar type. This calendar is used by the Google Calendar service. Note: See Declaring a variable for more details on the declaration of this type of variable and the use of WLanguage properties. | Caution: the access to the Google Calendars changes from November 17, 2014 From November 17 2014, Google is only using the Google API version 3 (Google API version 2 is abandoned). This change of version has modified the exchange format of data used by the functions for accessing the Google Calendars. An "OAuth 2.0" authentication is now required to access this service. This authentication mode requires: - the declaration of the application in the Google console. To use the Google Calendars, the application must use the "Calendar API" service.
- the use of new properties in the gglConnection variable.
See the help about GglConnect for more details. Caution: The gglCalendar, gglEvent and gglLocation variables are also modified. Some properties become obsolete with the Google API version 3: they must not be specified anymore. |
// Connection to Google Cnt is gglConnection Cnt..Email = "vince@gmail.com" Cnt..Password = "azerty" Cnt..ApplicationName = "MyApp-01" IF GglConnect(Cnt) = False THEN Error(ErrorInfo()) END ... // Retrieve the array of available calendars arrCalendars is array of gglCalendar arrCalendars = GglListCalendar(Cnt) // Retrieve all the events of the first calendar GglFillCalendar(Cnt, arrCalendars[1]) // Browse the events Evt is gglEvent FOR EACH Evt OF arrCalendars[1] Trace(Evt..Title) END
Remarks Properties specific to the description of gglEvent variables The following properties can be used to handle a calendar event via the gglEvent type: | | | Name | Type used | Effect |
---|
Author | gglAuthor | Author of the calendar. This property is accessible in read-only. | Content | Unicode character string | Description of event. | StartDate | DateTime | Start date of the event. Notes:- In the Google interface, if the event corresponds to a full day, the start date of the event is the one of the day at 0h00.
- The date is expressed in the time zone of the calendar.The date is expressed in the time zone of the local computer.
| EndDate | DateTime | End date of the event. Notes:- In the Google interface, if the event corresponds to a full day, the end date of the event is the one of the next day at 0h00.
- The date is expressed in the time zone of the calendar.The date is expressed in the time zone of the local computer.
| UpdateDate | DateTime | Date of event update. This property is accessible in read-only. Note: The date is expressed in the time zone of the calendar.The date is expressed in the time zone of the local computer. | PublicationDate | DateTime | Date of last access to the event. This property is accessible in read-only. Note: The date is expressed in the time zone of the calendar.The date is expressed in the time zone of the local computer.
Warning
From version 20, further to the implementation of Google API version 3, this property is not supported anymore.
| Versions 15 and laterIdentifier New in version 15Identifier Identifier | Unicode character string | Google identifier of the event. | Versions 18 and laterWholeDay New in version 18WholeDay WholeDay | - True if the event corresponds to entire days,
- False otherwise.
| Guest[n] | Array of gglPerson | List of participants to the event. Caution: When modifying an event, the participants are not automatically informed of the modifications performed. This feature must be programmed if necessary. | Location | List of locations associated with the event. | Title | Unicode character string | Title of event. | Note: These properties can be used with one of the following syntaxes: - <Variable name>..<Property name>
- <Variable name>.<Property name>
Versions 20 and laterManaging the dates and their time zone Further to the use of the "OAuth 2.0" authentication, the management of dates was modified. All the dates returned by GglGetCalendar, GglListCalendar, ... in the gglEvent variables are using the time zone of the local computer. Therefore, they can be directly used in a Calendar control with the current time zone. You have the ability to retrieve the time zone of the accessed calendar via the ..TimeZone property of the gglCalendar variables. The returned value corresponds to the name of the time zone, issued from the "tz" database (or Olson database). This name can be directly used by DateTimeLocalToTimeZone. New in version 20Managing the dates and their time zone Further to the use of the "OAuth 2.0" authentication, the management of dates was modified. All the dates returned by GglGetCalendar, GglListCalendar, ... in the gglEvent variables are using the time zone of the local computer. Therefore, they can be directly used in a Calendar control with the current time zone. You have the ability to retrieve the time zone of the accessed calendar via the ..TimeZone property of the gglCalendar variables. The returned value corresponds to the name of the time zone, issued from the "tz" database (or Olson database). This name can be directly used by DateTimeLocalToTimeZone. Managing the dates and their time zone Further to the use of the "OAuth 2.0" authentication, the management of dates was modified. All the dates returned by GglGetCalendar, GglListCalendar, ... in the gglEvent variables are using the time zone of the local computer. Therefore, they can be directly used in a Calendar control with the current time zone. You have the ability to retrieve the time zone of the accessed calendar via the ..TimeZone property of the gglCalendar variables. The returned value corresponds to the name of the time zone, issued from the "tz" database (or Olson database). This name can be directly used by DateTimeLocalToTimeZone.
This page is also available for…
|
|
|
| |
| Click [Add] to post a comment |
|
| |
|
| |
| |
| |
| |
| |
| |
| | |
| |