ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Google functions / Google Contacts
  • Possible error cases:
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
<gglConnection variable>.ListContact (Function)
In french: <Variable gglConnexion>.ListeContact
Warning
Since June 15, 2021, the Google Contacts API used by this feature is no longer available (https://developers.google.com/contacts/v3/announcement).
To use Google contacts, refer to the People API published by Google as a replacement : https://developers.google.com/people. <restRequest variable>.Send allows you to easily integrate a REST API in your development projects.
Retrieves the list of contacts associated with the specified Google account.
Example
// Connection
Cnt is gglConnection
...
// Retrieves all the contacts
arrContacts is array of 0 gglContact = Cnt.ListContact()
 
// Example with 10 contacts per page:
// First page
// Retrieves all the contacts, with a maximum of 10 contacts, starting from index 1
arrContacts = Cnt.ListContact("", 1, 10)
// Second page
// Retrieves all the contacts, with a maximum of 10 contacts, starting from index 11
arrContacts = Cnt.ListContact("", 11, 10)
// Browse the contacts
MyContact is dynamic gglContact
FOR EACH MyContact OF arrContacts
Trace(MyContact.Name)
END
Syntax
<Result> = <Google connection>.ListContact([<Group of contacts> [, <First element> [, <Maximum number of contacts>]]])
<Result>: Array of gglContact variables
Array of gglContact variables.
<Google connection>: gglConnection variable
Name of the gglConnection variable to be used. This connection was validated by <gglConnection variable>.Connect.
<Group of contacts>: Optional Unicode character string
Name or identifier of the group of contacts to list. If this parameter corresponds to an empty string (""), all the groups are listed. This parameter corresponds to an empty string by default.
<First element>: Optional integer
Number of the first contact to retrieve (1 by default). This parameter must be greater than or equal to 1.
<Maximum number of contacts>: Optional integer
Maximum number of contacts to retrieve (0 by default). If this parameter corresponds to 0, the maximum number of contacts is unlimited. This parameter must be greater than or equal to 0.
Remarks

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: wd290ggl.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help