GglFillCalendarByRequest (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

GglFillCalendarByRequest (Function)

In french: GglRemplitAgendaParRequête

Fills a calendar that was retrieved beforehand: the events corresponding to the calendar are retrieved from a custom request. This function must be used after the call to GglListCalendar.

Note: This function is an advanced function. We recommend that you use GglFillCalendar.

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.

Example

// Connection
Cnt is gglConnection
...
IF GglConnect(Cnt) = False THEN
Error(ErrorInfo())
RETURN
END
// Retrieve a calendar
arrCalendars is array of 0 gglCalendar
arrCalendars = GglListCalendar(Cnt)
Calendar = arrCalendars[1]
// Request:
// Retrieve the future events and organize them in chronological order
GglFillCalendarByRequest(Cnt, Calendar, "futureevents&orderby=starttime")

Syntax

<Result> = GglFillCalendarByRequest(<Google connection> , <Calendar> , <Parameters>)

<Result>: Boolean

True if the events have been retrieved,
False otherwise. To find out the error details, use ErrorInfo.

<Google connection>: gglConnection variable

Name of the gglConnection variable to use. This connection was validated by GglConnect.
Versions 20 and later
Caution: the properties of the gglConnection variable must be revised for the OAuth 2.0 authentication.
New in version 20
Caution: the properties of the gglConnection variable must be revised for the OAuth 2.0 authentication.
Caution: the properties of the gglConnection variable must be revised for the OAuth 2.0 authentication.

<Calendar>: gglCalendar variable

Name of gglCalendar variable to fill.

<Parameters>: Character string

Parameters that must be passed to the HTTP request. The parameters are separated by the & character. See the documentation about the Google Calendar service for more details.
Caution: When going from Google API version 2 to Google API version 3, the parameters to pass to the request have been modified by Google. See the documentation about the Google Calendar service for more details (https://developers.google.com/google-apps/calendar/v3/reference/).

Remarks

The dates sent to the Google server must be in UTC format. If necessary, use DateTimeLocalToUTC and DateTimeUTCToLocal to perform the conversions.

Component : wd240ggl.dll