Présentation et documentation du plugin Google Keep pour Jeedom

Le plugin permet de synchroniser ses notes Google Keep avec Jeedom.
Il utilise l’API non officielle gkeepapi (GitHub: https://github.com/kiwiz/gkeepapi, documentation : http://gkeepapi.readthedocs.io)

Il gère les notes, les listes, les images, les dessins, les enregistrements, les émoticônes.

Configuration

Après avoir installé le plugin, démarrez les dépendances si elles ne se lancent pas automatiquement.

Choisissez un intervalle de rafraîchissement des données.
Entrez le nombre de comptes que vous voulez synchroniser.
Et saisissez ensuite les informations de connexion de chaque compte Google Keep.
Si votre compte est protégé par l’authentification en 2 étapes, créez un mot de passe d’application (voir https://support.google.com/accounts/answer/185833?hl=fr)

Si la connexion avec mot de passe d’application échoue (UNKNOWN_ERR notamment), utilisez la méthode avec navigateur :

  1. Relancez les dépendances pour actualiser gpsoauth et gkeepapi.
  2. Dans la configuration, renseignez l’adresse du compte Google puis sauvegardez.
  3. Dans Connexion Google avec navigateur, cliquez sur Ouvrir Google et authentifiez-vous avec ce même compte, y compris la validation 2FA demandée.
  4. Après avoir accepté la demande Google, la page peut rester sur Bienvenue ou un chargement : n’attendez pas de retour automatique vers Jeedom.
    Dans cet onglet Google, ouvrez les outils de développement avec F12 (Mac : Option + Commande + I). Allez dans Application (menu » si masqué), puis Stockage → Cookies → https://accounts.google.com.
    Filtrez sur oauth_token, sélectionnez la ligne et copiez uniquement sa Valeur.
    Si cette ligne est absente, vérifiez que le consentement Google a été accepté, puis recommencez depuis Ouvrir Google.
    Le cookie ne se récupère pas dans l’onglet Jeedom.
    L’adresse de la page, son paramètre TLet le fragment #close ne sont pas le jeton.
  5. Collez cette valeur dans le champ du plugin, conservez ou renseignez un Android ID de 16 caractères hexadécimaux, puis cliquez sur Valider la connexion Google.
  6. Après confirmation, rechargez la configuration avant toute nouvelle sauvegarde et lancez la synchronisation.

Sauvegardez, puis cliquez sur le bouton Première Connexion.
Le champ Jeton d’accès se remplit après quelques secondes.

Allez maintenant sur la page des équipements et lancez une Synchronisation.

Équipements créés

Pour chaque note ou liste, un équipement est créé.
Il est alors classé selon l’ordre fourni par Google Keep et selon les rubriques suivantes :

Épinglétrue/false
Archivétrue/false
Supprimétrue/false

Le logo de chaque équipement est coloré de la couleur indiquée dans Google Keep.

Multi-compte

Il est possible d’afficher les équipements d’un compte, ou de plusieurs à la fois, en cliquant sur l’adresse du compte en haut à droite.

Créer une note

Il est possible de créer une note depuis le plugin pour qu’elle apparaisse dans Google Keep en cliquant sur Ajouter.

Complétez la page qui vient de s’ouvrir (tous les champs ne sont pas obligatoires).
Il est possible d’ajouter autant d’élément que désiré pour un liste.

Commandes disponibles

Note

NomTypePrésenceValeur
Supprimer la noteaction otherRequise
Rafraîchiraction otherRequise
Épingler la noteaction otherRequise
Archiver la noteaction otherRequise
Désépingler la noteaction otherRequisechemin vers le fichier téléchargé
Restaurer la noteaction otherRequise
Désarchiver la note]action otherRequise
Fichier image [n]info stringSi image dans la notechemin vers le fichier téléchargé
Fichier audio [n]info stringSi enregistrement dans la notechemin vers le fichier téléchargé
Fichier video [n]info stringSi enregistrement dans la notechemin vers le fichier téléchargé
Texteinfo stringRequiseContenu de la note

Liste

NomTypePrésenceValeur
Archiver la noteaction otherRequise
Désarchiver la noteaction otherRequise
Désépingler la noteaction otherRequise
Épingler la noteaction otherRequise
Rafraîchiraction otherRequise
Restaurer la noteaction otherRequise
Supprimer la noteaction otherRequise
Supprimer un itemaction messageRequiseID de l’item à supprimer
Ajouter un itemaction messageRequiseTexte de l’item
[id]info stringUne commande par item (case à cocher)Contenu de l’item

L’ordre des commandes est identique à l’app Google Keep : les cases non cochées, puis Ajouter un item, puis les cases non cochées.
Chaque item peut être modifié, supprimé, coché, et chaque modification est transmise directement à Google Keep. (temps de transmission peut être plus ou moins long)

Widget dashboard

Chaque note peut être épinglée/désépinglée, archivée/désarchivée ou supprimée/restaurée depuis le dashboard ou panel.
La couleur de fond correspond à la couleur de l’app.

Panel

Le panel desktop contient tous les équipements affiché l’un à la suite de l’autre dans le même ordre que l’app Google Keep : épinglés, puis ordres choisi puis archivés.

Le code est ouvert à suggestion, amélioration, correction sur le GitHub https://github.com/Flobul/Jeedom-gkeep

Loading

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *