Pré-requis pour l'authentification OAuth 2.0

1. Cliquez sur "Créer un projet". Donnez le nom de votre projet. Un identifiant est automatiquement proposé pour votre projet.
2. Validez
3. Le projet est créé.
4. Dans le menu de gauche, cliquez sur "API et authentification" puis sur "API".
5. Choisissez les services dont l'application a besoin :
   • Pour l'accès aux agendas, choisissez "Calendar API" (catégorie "Google Apps APIs").
   • Pour l'accès aux contacts, choisir "Contacts API" (catégorie "Google Apps APIs").
   • Pour l'accès aux documents Google, choisir "Drive API" (catégorie "Google Apps APIs").
   • Pour l'accès aux albums Picasa et aux documents, aucune API spécifique n'est à sélectionner.
6. Dans le menu de gauche, cliquez sur "Identifiants".
7. Cliquez ensuite sur le bouton "Créer un identifiant client".
   • Sélectionnez le type d'application "Application installée".
   • A la première création de l'identifiant client, il est nécessaire de configurer l'écran d'autorisation.
   • Dans l'écran d'autorisation, dans la zone "Nom de produit", saisissez par exemple le nom de votre application.
   • Cliquez sur "Enregistrer".
   • L'écran de création de l'identifiant client s'affiche à nouveau.
     • Pour les applications WINDEV, sélectionnez "Application installée" puis "Autre".
     • Pour les sites WEBDEV, sélectionnez "Application Web". Dans la zone "URI de redirection autorisés", saisissez l'adresse du serveur Web sur lequel votre site est installé suivie de "/WD300AWP/WD300Awp.exe/GGLCONNECT_RETOUR". La syntaxe est du type :
       
       http[s]://<Nom_ou_IP_Serveur>[:<Port>]/WD300AWP/WD300AWP.exe/GGLCONNECT_RETOUR
       
       Par exemple :
       • En mode test, avec un serveur Web configuré sur le port par défaut (80) :
         
         http://localhost/WD300AWP/WD300AWP.exe/GGLCONNECT_RETOUR
       • En mode test, avec un serveur Web configuré sur le port 8080 :
         
         http://localhost:8080/WD300AWP/WD300AWP.exe/GGLCONNECT_RETOUR
       • En déploiement Internet, avec un serveur Web configuré sur le port par défaut avec comme domaine "www.mondomaine.com" :
         
         http://www.mondomaine.com/WD300AWP/WD300AWP.exe/GGLCONNECT_RETOUR
       • En déploiement Internet, avec un serveur Web configuré en https sur le port par défaut (443) avec comme domaine "www.mondomaine.com" :
         
         https://www.mondomaine.com/WD300AWP/WD300AWP.exe/GGLCONNECT_RETOUR
       • En déploiement Intranet, avec un serveur Web configuré sur le port 81 avec comme nom de machine "ServeurIntranet" :
         
         http://ServeurIntranet:81/WD300AWP/WD300AWP.exe/GGLCONNECT_RETOUR
   • Validez. Les identifiants client sont créés :
     • Identifiant client. Cet identifiant est à conserver. Il sera utilisé dans la variable de type gglConnexion.
     • Code secret du client. Cet identifiant est à conserver. Il sera utilisé dans la variable de type gglConnexion.
     • URI de redirection. Vérifiez que "http://localhost" est précisé.

Authentification OAuth 2.0

1. L'ouverture d'une fenêtre de login pour l'utilisateur final. Si la propriété Email de la variable gglConnexion est spécifiée, Google pré-remplit la fenêtre de connexion avec l'adresse email indiquée. Si l'utilisateur est déjà connecté, la fenêtre de login ne s'affiche pas.
2. L'ouverture de la fenêtre d'autorisation. L'utilisateur final doit autoriser l'application à accéder à son compte. Cette fenêtre se ferme automatiquement lorsque l'utilisateur accepte ou annule.

• Si la syntaxe 1 est utilisée (connexion avec authentification de base), une fenêtre d'autorisation sera affichée à chaque tentative d'accès à un nouveau service.
• Si la syntaxe 2 est utilisée (connexion en spécifiant les services utilisés), une fenêtre d'autorisation sera affichée pour tous les services demandés au début de l'application.
• La fenêtre d'autorisation peut être affichée uniquement au premier lancement de l'application si la persistance de la connexion est gérée (voir paragraphe suivant).

Limitations : L'authentification OAuth 2.0 n'est pas gérée si la connexion a besoin d'interactivité (validation des pages Google) :

• Dans les Webservices.
• En Ajax.
• Dans les tâches planifiées WEBDEV.
• Dans les tâches différées WEBDEV.
• Dans les threads.

Dans ce cas, il est conseillé d'utiliser la persistance de la connexion.

Attention : Le timeout de la session s'applique également pendant l'affichage des pages de connexion Google.

Persistance de la connexion

soit sFichierPersistanceAuth = SysRep(srAppDataLocal) + [fSep] + "authggl.xml"

cnx est une gglConnexion
// Si connexion déjà effectuée
SI fFichierExiste(sFichierPersistanceAuth) ALORS 
	// Restauration de la connexion 
	soit bufDésérialise = fChargeBuffer(sFichierPersistanceAuth) 
	Désérialise(cnx, bufDésérialise, psdXML) 
SINON 
	// Nouvelle connexion 
	cnx.Email = "email@gmail.com" 
	cnx.ClientID = "387756281032-qffa6dajjd5348iqhi558xxxxxxxx.apps.googleusercontent.com" 
	cnx.ClientSecret = "Sxxxxx-jLMwwh" 
FIN 

SI GglConnecte(cnx, gglServiceAgenda) ALORS 
	// Sauvegarde de la connexion pour réutilisation future 
	bufSérialise est un Buffer 
	Sérialise(cnx, bufSérialise, psdXML) 
	fSauveBuffer(sFichierPersistanceAuth, bufSérialise) 
FIN