<gglConnection variable>.Write (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Case of the Google Picasa albums and their photos
Possible error cases:

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<gglConnection variable>.Write (Function)

In french: <Variable gglConnexion>.Ecrit

Creates and/or updates data on the Google server (addition or modification of data). The created or updated data is contained in a variable that corresponds to the service used:

gglCalendar variable to create/update the calendar.
gglContact variable to create/update the contacts (see the Examples).
gglContactGroup variable to create/update the groups of contacts (see the Examples).
gglAlbum variable to create/update a Picasa album.
gglPhoto variable to create/update a photo in a Picasa album.

Remarks:

In case of multiple additions, VariableReset is used to reinitialize these variables between the calls to <gglConnection variable>.Write.
For a modification, the data must be retrieved before it can be modified.

Example

// Connection
Cnt is gglConnection
...

// Retrieve the calendar named "Work"
Calendar is gglCalendar = Cnt.GetCalendar("Work")
// Modify the first event of the calendar
Calendar[1]..Title = "Apt with boss"
Calendar[1]..EndDate = "20081013153"
// Delete the second event from the calendar
Delete(Calendar..Event, 2)
// Actually update the changes on the server
Cnt.Write(Calendar)

Syntax

Creating and/or updating a Google element Hide the details

<Result> = <Google connection>.Write(<Google element>)

<Result>: Boolean

True if the update was performed,
False if an error occurred. To find out the error details, use ErrorInfo.

<Google connection>: gglConnection variable

Name of gglConnection variable to use. This connection was validated by <gglConnection variable>.Connect.
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.

<Google element>: Variable corresponding to the type to update

Element to update. This parameter can correspond to:
Name of the gglCalendar variable corresponding to the calendar to create/modify.
Name of the gglContact variable corresponding to the contact to create/modify.
Name of the gglContactGroup variable corresponding to the group of contacts to create/modify.
Name of the gglAlbum variable corresponding to the Picasa album to create/modify.
Name of the gglPhoto variable corresponding to the photo of the Picasa album to create/modify.

Remarks

Case of the Google Picasa albums and their photos

To add a photo into the album:

describe the photo via a gglPhoto variable.
add the photo to the album (each photo is an element of the PhotoData array found in the gglAlbum variable).
use <gglConnection variable>.Write on the gglAlbum variable to update the album on the Google server.

To modify a photo in the album:

modify the characteristics of the photo in the album (via a gglPhoto variable if necessary).
use <gglConnection variable>.Write on the gglPhoto variable corresponding to the photo to modify to update the album on the Google server.

If <gglConnection variable>.Write is directly used with a gglPhoto variable (not linked to an album), the photo will be created/transferred into a generic album named "Transferred files".

Possible error cases:

The Internet connection is not valid.
The authentication was not performed properly.
The XML response of the server cannot be read.

Business / UI classification : Business Logic

Component : wd250ggl.dll