<gglConnection variable>.ListAlbum (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | Français

Retrieving an album
Possible error cases:

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<gglConnection variable>.ListAlbum (Function)

In french: <Variable gglConnexion>.ListeAlbum

Warning
From January 2019, the functions for managing Google Picasa photo albums will no longer be available. Indeed, the corresponding Google API is no longer available from January 2019. It is necessary to use "Google Photo API"..
This new API is accessible via AuthIdentify and HTTP requests. See https://developers.google.com/photos/library/guides/overview for more details.

Retrieves the list of "Google Picasa" albums available to the user.

Example

// Connection to Google
Cnt is gglConnection
...
IF Cnt.Connect() =False THEN
Error(ErrorInfo())
END

// Retrieve the albums with the cover images
arrAlbums is array of gglAlbum = Cnt.ListAlbum(gglWithImage)

Syntax

<Result> = <Google connection>.ListAlbum([<Options>])

<Result>: Array of gglAlbum variable

Array of gglAlbum variable. Each element found in this array contains the characteristics of an album. The number of elements in this array corresponds to the number of available albums.

<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.

<Options>: Optional Integer constant (or combination of constants)

Options for retrieving the album:
gglWithPhotoData The characteristics of the photos found in the albums are downloaded. Then, the ..PhotoData property of the gglAlbum variable will be filled. The image of the photo can be retrieved by <gglConnection variable>.FillPhoto.
gglWithImage The photos of the cover images of the albums are downloaded. Then, the ..Image property of the gglAlbum variable will be filled.
gglWithTag The tags of albums are downloaded. Then, the ..Tag property of the gglAlbum variable will be filled.
gglWithThumbnail The thumbnails of the cover images are downloaded. Then, the ..Media..Thumbnail property of the gglAlbum variable will be filled.

If no constant is specified, the album will be retrieved without photo, without cover image, without tag and without thumbnail.

Remarks

Retrieving an album

To retrieve an album, you have the ability to use:

<gglConnection variable>.ListAlbum to find out the list of available albums.
<gglConnection variable>.GetAlbum to retrieve a specific album.
<gglConnection variable>.FillAlbum to retrieve the characteristics of an album (an album listed by <gglConnection variable>.ListAlbum for example).

To retrieve the images linked to the album, you must browse through the album photos and use <gglConnection variable>.FillPhoto.

See Creating and modifying a Picasa album for more details.

Possible error cases:

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

To find out whether an error occurred, use the ErrorOccurred variable.

Component : wd250ggl.dll